home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / mp325-2.zip / MULTIPL.002 < prev   
Text File  |  1994-04-10  |  133KB  |  2,779 lines
  1. ------------------------------------------------------------------------------
  2.  Digital Music Formats
  3. ------------------------------------------------------------------------------
  4.  SoundTracker                           MOD
  5.  NoiseTracker                           NST - MOD
  6.  ProTracker                             MOD
  7.  4-Channel StarTrekker                  MOD
  8.  Triton FastTracker                     MOD - 6CM - 8CM
  9.  Scream Tracker 2.0                     STM
  10.  Scream Tracker 3.0 beta                S2M - S3M
  11.  Scream Tracker 3.0                     S3M
  12.  Grave                                  WOW
  13.  669 Composer                           669
  14.  Oktalyzer                              OKT
  15.  OctaMED                                MED
  16.  MultiTracker                           MTM
  17.  ProTracker Studio 16                   P16
  18.  Advanced Module File                   AMF
  19. ------------------------------------------------------------------------------
  20.  FM Music Formats
  21. ------------------------------------------------------------------------------
  22.  Adlib Music File                       ROL
  23.  Creative Music File                    CMF
  24.  Standard MIDI File                     MID
  25. ------------------------------------------------------------------------------
  26.  Sample Formats
  27. ------------------------------------------------------------------------------
  28.  Creative Voice File                    VOC
  29.  Microsoft Windows WAVE/RIFF File       WAV
  30.  Raw Sample File                        RAW
  31. ------------------------------------------------------------------------------
  32.  Graphic Image Formats
  33. ------------------------------------------------------------------------------
  34.  VGAGRAB Dump Images                    DMP
  35.  ANIVGA Pictures                        PIC
  36.  HANDY Scanner 2000 (Postering)         HS2
  37.  ZSoft/Microsoft PaintBrush             PCX
  38.  Compuserve Graphic Interch. Format     GIF
  39.  ColorRix VGA Paint                     SCI
  40.  Autodesk Animator FLIC animation       FLI
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.      █▄   ▄█     █ █   █ █▀▀▄ █                          (c) █
  48.      █ █ █ █     █ █▄    █  █ █                 (tm)       ▄▄█ ▄▄▄  ▄▄
  49.      █  █  █ █ █ █ █   █ █▄▄▀ █ ▀▀█ █ █ █▀█ █▀█            █▄█ █▄█ ▄█
  50.      █     █ █ █ █ █   █ █    █ ▄▄█ █ █ █▀▀ █                  ▄▄█
  51.      █     █ █▄█ █ █▄█ █ █    █ █▄█ █▄█ █▄█ █  v3.25                 1994
  52.                                      █
  53.          The Multimedia Desktop     █
  54.  
  55.  
  56.  
  57.                                   MULTIPLAYER
  58.                                  Version  3.25
  59.  
  60.                (C) 1993-94 DGS Italian Software Company / ExCiTe!
  61.  
  62.  
  63.  
  64.  
  65. ┌────────────────────────────────────────────────────────────────────────────┐
  66. │                                                                            │
  67. │                                 User Manual                                │
  68. │                                                                            │
  69. └────────────────────────────────────────────────────────────────────────────┘
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101. DUAL MODULE PLAYER is a program (C) by Otto Chrons 1992, 1994.
  102. VANGELISTRACKER is a program (C) by VangelisTeam 1992.
  103.  
  104. IBM and OS/2 are registered trademarks of International Business Machines.
  105. PKZIP and PKUNZIP are registered trademarks of PKWARE, Inc.
  106. GIF is a registered trademark of CompuServe, Inc.
  107. PCX is a registered trademark of ZSoft Corporation.
  108. SCI and ColorRIX are registered trademarks of RIX Software.
  109. FLI and AutoDesk Animator are registered trademarks of Autodesk Corporation.
  110.  
  111. SOUNDBLASTER, SOUNDBLASTER PRO and SOUNDBLASTER (ASP) 16 are registered trade
  112. marks of Creative Labs.
  113.  
  114. PRO AUDIO SPECTRUM is a registered trademark of MediaVision, inc.
  115. WINDOWS and WINDOWS SOUND SYSTEM are registered trademarks of Microsoft Corp.
  116. GRAVIS ULTRASOUND is a registered trademark of Gravis.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152. ┌────────────────────────────────────────────────────────────────────────────┐
  153. │                                                                            │
  154. │                                    INDEX                                   │
  155. │                                                                            │
  156. └────────────────────────────────────────────────────────────────────────────┘
  157.  
  158. 1.  INTRODUCTION
  159.     1.1. What is Multiplayer?
  160.     1.2. Playing modes
  161.     1.3. Music files
  162.     1.4. Picture files
  163.     1.5. Text files
  164.  
  165. 2.  MULTIPLAYER INSTALLATION
  166.     2.1. Hardware required
  167.     2.2. Sound devices
  168.     2.3. Setup and running
  169.  
  170. 3.  MULTIPLAYER'S DESKTOP
  171.     3.1. Main desktop
  172.     3.2. File menu
  173.     3.3. Setup menu
  174.     3.4. Devices menu
  175.     3.5. MIDI menu
  176.  
  177. 4.  PLAYBACK
  178.     4.1. Multiplayer windows
  179.     4.2. Hotkeys
  180.     4.3. Mixer control panel
  181.     4.4. The VDS subsystem (version 1.063)
  182.  
  183. 5.  ERROR MESSAGES
  184.  
  185. 6.  MULTIPLAYER SCRIPT LANGUAGE
  186.     6.1. Command description, and examples
  187.  
  188. 7.  UTILITIES
  189.  
  190. 8.  WHAT TO DO?
  191.  
  192. 9.  INTERNET SUPPORT
  193.  
  194. 10. ELECTRICAL SCHEMES FOR COVOX COMPATIBLE DACs
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210. ┌────────────────────────────────────────────────────────────────────────────┐
  211. │                                                                            │
  212. │                               1. INTRODUCTION                              │
  213. │                                                                            │
  214. └────────────────────────────────────────────────────────────────────────────┘
  215.  
  216.  
  217. 1.1. What is Multiplayer?
  218.      --------------------
  219.  
  220. MULTIPLAYER 3.25 is more than a module player. It's a graphics/music desktop,
  221. allowing you to:
  222.  
  223. - play the most important types of digitized music files (modules) on any DAC
  224.   based sound device.
  225. - play some popular sample format (VOC, WAV or RAW) on a SoundBlaster Card or
  226.   any compatible sound card.
  227. - play synthetized music (CMF, ROL or MID) on all SoundBlaster Cards.
  228. - display some popular image format (HS2, DMP, PIC, PCX, SCI or GIF) and ani-
  229.   mation sequences (FLI) on your VGA card.
  230. - execute scripts written in a language, the MPS (Multiplayer Script), useful
  231.   for creating graphic presentations. See section 6.1, for a full description
  232.   of MPS instructions.
  233. - show text files, having DOC or TXT extension.
  234.  
  235. Unlike actual module players available for PCs, MultiPlayer is not a command-
  236. line program,  but a menu-driven program. It can work as a stand-alone player
  237. but it can be also used as a front-end for some module/FM player available in
  238. the Public Domain. In the first case MultiPlayer provides a nice text screen,
  239. shown during module playing, allowing you to give your own effects to song.
  240.  
  241. MultiPlayer was written in Borland Pascal 7.0, by using a modificated version
  242. of VangelisTracker sound routines, and DSMI, a sound package by Otto Chrons.
  243.  
  244.  
  245. 1.2. Playing Modes
  246.      -------------
  247.  
  248. A digitized music file can be played by using different ways, called 'modes':
  249.  
  250. - Classic Mode : it works in the way MultiPlayer 1.x versions do. It includes
  251.   full support for PC Speaker, Covox and Sound Blaster Card. It plays a large
  252.   number of mod types, but limited to 64k-length samples.You can use only me-
  253.   mory under 640k base memory for a module. In Low Quality Mode, you can play
  254.   module bigger than 640k  (up to 800k, sometimes), but you can notice a loss
  255.   of sound quality.
  256.  
  257. - Classic/Graph Mode : it works with all devices and module types Classic Mo-
  258.   de uses, but using a graphic display. A VGA card is needed.
  259.  
  260. - Advanced Mode : it uses enhanced module routines, written in 80386 assembly
  261.   language. A smaller number of module types can be played, but they can have
  262.   samples bigger  than 64k bytes.  Also, more sound devices are available and
  263.   the sound quality is better than Classic Mode.  You can use only memory un-
  264.   der 640k base memory for a module.
  265.  
  266. - DMP Mode : in this case, MultiPlayer can be used as a front-end (shell) for
  267.   the Otto Chrons' Dual Module Player (version 2.86 or upper is recommended).
  268.   Supporting DMP is important 'cause of a great DMP feature, the DOS/EMS mode
  269.   allowing to play modules larger than conventional memory.
  270.  
  271. - DMP/32 Mode : like previous mode, but it uses DMP32, the Dual Module Player
  272.   protected mode version.
  273.  
  274. - Automatic Mode : it selects automatically classic, advanced or dmp mode, on
  275.   the basis of the sound device you selected or the module type you play.
  276.  
  277. - Editing Mode : allowing you to edit modules,  invoking Dark Tracker Editor,
  278.   (DARKEDIT.EXE) a public domain editor.  You must have a VGA graphic card, a
  279.   mouse and a SoundBlaster Card in order to run it.
  280.  
  281. Note 1 : all modes have a sense only when one or more digital module file are
  282.          selected. When a synthetized music, an image or a text file is sele-
  283.          cted, it will be played or shown, whatever current mode is.
  284.  
  285.  
  286. 1.3. Music Files
  287.      -----------
  288.  
  289. A lot of music files is supported by Multiplayer. Depending on mode currently
  290. selected, some music format could not be playable. In Classic Mode, a maximum
  291. of 64 channels is possible, if a SoundBlaster Pro (or a better card) is used.
  292. Channel Limit is set to 16 for PC Speaker, Covox, and monophonic SoundBlaster
  293. cards.
  294.  
  295. ------------------------------------------------------------------------------
  296. - MOD - SoundTracker / NoiseTracker / ProTracker / Startrekker / ModEdit
  297. ------------------------------------------------------------------------------
  298.         this is the original Amiga SoundTracker 4-channel format.  At the be-
  299.         ginning, it supported only 15 instruments, then, NoiseTracker increa-
  300.         se number of instruments to 31. All MOD files created on Amiga have a
  301.         three octave range  (1-3).  On PCs, MOD format was slighty changed so
  302.         that five octaves (range 0-4) can be played. Norman Lin's ModEdit mo-
  303.         dules  are recognized  by  Multiplayer,  but they could not be played
  304.         correctly 'cause of ten octave range used by this program.
  305. ------------------------------------------------------------------------------
  306. - 6CM/8CM - Triton FastTracker
  307. ------------------------------------------------------------------------------
  308.         they are variants of Protracker format (xCM is for x-Channel Module),
  309.         created by a popular composer for PCs, the Triton FastTracker. A com-
  310.         plete set of Protracker effects is supported. Since their file struc-
  311.         ture is very similar to MOD format, they can have .MOD extension too.
  312. ------------------------------------------------------------------------------
  313. - WOW - Grave Mod Player
  314. ------------------------------------------------------------------------------
  315.         this is another small variation  on Protracker format, but it  uses 8
  316.         channels  and 31 unsigned samples. These  mods can be recognized only
  317.         by file extension (WOW), so it cannot be changed. This  format is not
  318.         very popular, but some public domain utility can be found for conver-
  319.         ting other formats (MOD, 669) to the WOW format.
  320. ------------------------------------------------------------------------------
  321. - STM - Scream Tracker 2.2
  322. ------------------------------------------------------------------------------
  323.         this is the module format that has become a standard on PCs, by an e-
  324.         ditor created on 1990. It uses 4 channels and 31 samples. It's sligh-
  325.         tly different from MOD format, but it have some effect more.
  326. ------------------------------------------------------------------------------
  327. - S3M - Scream Tracker 3.0
  328. ------------------------------------------------------------------------------
  329.         this is the new Scream Tracker format, but an official editor doesn't
  330.         exist yet. It is used in Future Crew's demos and music disks.  It can
  331.         have up to 32 channels and 64 digital instruments.
  332. ------------------------------------------------------------------------------
  333. - 669 - The 669 Composer
  334. ------------------------------------------------------------------------------
  335.         this is a new format created on PCs on '92. All module have 8 channel
  336.         patterns. A public domain file converter is available, for converting
  337.         standard MODs to the 669 format.
  338. ------------------------------------------------------------------------------
  339. - OKT - Oktalyzer
  340. ------------------------------------------------------------------------------
  341.         This is the first eight-channel module format for Commodore Amiga. It
  342.         was supported by a tracker called OKTALYZER, but it's no  longer used
  343.         by Amiga users and musicians.
  344. ------------------------------------------------------------------------------
  345. - MED - OctaMED Pro
  346. ------------------------------------------------------------------------------
  347.         a module format written by Teijo Kinnunen on Amiga (editor needed for
  348.         them is called MED or OctaMED).  MED has currently two variants (type
  349.         0 and 1), and can have over than 60 instruments, synthetic or digital
  350.         (or both). Multiplayer can play digital instruments only. OctaMED can
  351.         have a large  number of rows per pattern (up to 3200) but MultiPlayer
  352.         can play  only modules having up to 128 rows per pattern.  Also, MEDs
  353.         can have more than one module per file, but Multiplayer can play only
  354.         the first module stored in the file.
  355. ------------------------------------------------------------------------------
  356. - MTM - MultiTracker Module Editor
  357. ------------------------------------------------------------------------------
  358.         a 32-channel format implemented by Daniel Goldstein in his editor. It
  359.         supports also 16-bit samples and auto-panning setting, but these fea-
  360.         tures are not implemented in MultiPlayer.
  361. ------------------------------------------------------------------------------
  362. - ULT - UltraTracker
  363. ------------------------------------------------------------------------------
  364.         a module supporting up to 32 channels, 16-bit samples and AutoPanning
  365.         commands. Multiplayer can handle 8-bit samples only and discards some
  366.         not Protracker commands used by this format (AutoPanning included).
  367. ------------------------------------------------------------------------------
  368. - LIQ - Liquid Tracker
  369. ------------------------------------------------------------------------------
  370.         a module format supporting up to 64 channels, 64 samples, several ef-
  371.         fects (similar to Protracker commands, but coded in a different way).
  372. ------------------------------------------------------------------------------
  373. - FAR - Farandole Composer
  374. ------------------------------------------------------------------------------
  375.         a module format used by a public domain tracker for Gravis UltraSound
  376.         cards. It has 16 channels;it can handle up to 256 instruments and 256
  377.         patterns. Multiplayer includes a utility for converting  all standard
  378.         MODs (NoiseTracker, ProTracker and FastTracker) to Farandole format.
  379.         Since Farandole format is still in beta-test, Multiplayer could  play
  380.         some module wrong.
  381. ------------------------------------------------------------------------------
  382. - P16 - ProTracker Studio 16
  383. ------------------------------------------------------------------------------
  384.         this is the module format called 'Protracker Studio 16' format. It is
  385.         written by Joshua C. Jensen, the Super Play Pro author.  All P16 mods
  386.         have 16 channels and 31 instruments.  Unlike other module types,  P16
  387.         modules  can have synthetic instruments too,  but this feature is not
  388.         recognized by Multiplayer. For useful informations about this format,
  389.         look for PS16FORM.LZH, a public domain package. It includes a program
  390.         for converting MOD files to the P16 format, and some documentation.
  391.         Note:a new Protracker Studio 16 (PSM) format is more used now. It was
  392.         utilized in Epic Pinball game. Multiplayer cannot play these songs.
  393. ------------------------------------------------------------------------------
  394. - AMF - Advanced Module Format
  395. ------------------------------------------------------------------------------
  396.         This is the DMP's internal format, created by Otto Chrons,  a general
  397.         format compatible with all kind of mods. You can convert all mods re-
  398.         cognized by DMP (see below), by using M2AMF conversion utility provi-
  399.         ded with Otto Chrons' Dual Module Player. AMF format can be different
  400.         slightly, according to a specific DMP version. You can use AMFVER.EXE
  401.         to know what is the version number for an AMF module.
  402. ------------------------------------------------------------------------------
  403. - CMF - Creative Music File
  404. ------------------------------------------------------------------------------
  405.         It's a FM-music file created by Creative Labs, so you can play it  if
  406.         you have a SoundBlaster Card (or compatible). You must load a SBFMDRV
  407.         driver (included in a SoundBlaster diskette) in memory before you use
  408.         MultiPlayer.
  409. ------------------------------------------------------------------------------
  410. - ROL - Adlib Music File (Roland)
  411. ------------------------------------------------------------------------------
  412.         This is the Adlib FM music file format. A lot of ROLs can be found on
  413.         public domain. You must have a FM sound driver like SOUND.COM program
  414.         provided with Adlib Sound Card (SoundBlaster Cards should use an enh-
  415.         anced driver called SB-SOUND.COM). This sound driver should be loaded
  416.         in memory as a TSR, before you load Multiplayer. Also,  you must have
  417.         SPUTROL player in your PATH statement and a BANK Instrument Data File
  418.         (BNK) containing all instruments needed for playing ROL files. A Bank
  419.         Data File is included in Multiplayer distribution file.
  420. ------------------------------------------------------------------------------
  421. - MID - Standard MIDI File
  422. ------------------------------------------------------------------------------
  423.         This is the most common format used by music synthetizers and sequen-
  424.         cers. It can be played on a music keyboard or a synthetizer through a
  425.         MIDI device (SoundBlaster, MPU401, and so on). Multiplayer uses a ex-
  426.         ternal program for playing MIDI files, according to your choice.  See
  427.         sections 3.3 and 3.5 for full instructions.
  428. ------------------------------------------------------------------------------
  429. - VOC - Creative Voice File
  430. ------------------------------------------------------------------------------
  431.         This is the Creative Voice File Format for digitized samples. To play
  432.         VOC files, you must have a SoundBlaster or compatible and the CT-VOI-
  433.         CE.DRV driver file copied in your  SoundBlaster directory.  VOC files
  434.         can have any length  (they will be loaded and played one segment at a
  435.         time, by using DMA),but only monophonic VOC files will be played cor-
  436.         rectly (even if compressed). Stereo VOCs created by using the Creati-
  437.         ve Labs' Voice Editor, or some other stereo sampler,  could hang your
  438.         PC.
  439. ------------------------------------------------------------------------------
  440. - WAV - Microsoft Windows' WAVE/RIFF File
  441. ------------------------------------------------------------------------------
  442.         Similar to .VOC, provides more channels and 16-32 bit samples. It was
  443.         a native format for Microsoft Windows 3.1. Multiplayer can handle on-
  444.         ly 8 bit WAV samples smaller than 350k.
  445. ------------------------------------------------------------------------------
  446. - RAW - Raw Sample
  447. ------------------------------------------------------------------------------
  448.         It has no header. RAW Samples are created by Multiplayer when you hit
  449.         'S' or 'D' key during a module playback  (it will save all module in-
  450.         struments).  Also, they can be  created by using a 'Raw  Sample File'
  451.         device (see above). Multiplayer can load samples up to expanded memo-
  452.         ry free amount long.
  453. ------------------------------------------------------------------------------
  454.  
  455. Note 1 : OKT, WOW, 669, MED, ULT and P16 modules are available in Classic Mo-
  456.          de only. AMF modules from release 1.01 to 1.11 (supported by DMP re-
  457.          lease 2.72) can be played by Advanced Mode only.  Multiplayer cannot
  458.          play the AMF modules v1.12 or upper. If you want to play them, use a
  459.          DMP release 2.74 or newer and switch Multiplayer to DMP mode.
  460.  
  461. Note 2 : You can find some module with the HUC extension. These files are pa-
  462.          cked by a Huffman/RLE-based file compressor. MultiPlayer unpack them
  463.          in a temporary file before loading.
  464.  
  465. Note 3 : CMF and VOC files are played only on SoundBlasters or compatible. Be
  466.          sure to install the correct I/O Address on your SoundBlaster  before
  467.          playing them.
  468.  
  469. Following table shows what kind of modules are recognized by MultiPlayer pla-
  470. ying modes:
  471.  
  472. ────────────────────────────────────────────────────────────────────────────
  473. │ Playing Mode │MOD│6CM│8CM│WOW│STM│S3M│669│OKT│MED│P16│MTM│ULT│LIQ│AMF│FAR│
  474. ────────────────────────────────────────────────────────────────────────────
  475. │ CLASSIC      │ X │ X │ X │ X │ X │ X │ X │ X │ X │ X │ X │ X │ X │   │ X │
  476. │ ADVANCED     │ X │ X │ X │   │ X │ X │   │   │   │   │   │   │   │ X │   │
  477. │ AUTOMATIC    │ X │ X │ X │ X │ X │ X │ X │ X │ X │ X │ X │ X │ X │ X │   │
  478. │ DMP-DMP/32   │ X │ X │ X │   │ X │ X │ X │   │   │   │ X │   │   │ X │ X │
  479. │ EDITING      │ X │   │   │   │   │   │   │   │   │   │   │   │   │   │   │
  480. ────────────────────────────────────────────────────────────────────────────
  481. │ Playing Mode │CMF│ROL│MID│VOC│WAV│RAW│                                   │
  482. ────────────────────────────────────────────────────────────────────────────
  483. │ CLASSIC      │   │   │   │   │   │   │                                   │
  484. │ ADVANCED     │   │   │   │   │   │   │                                   │
  485. │ AUTOMATIC    │ X │ X │ X │ X │ X │ X │                                   │
  486. │ DMP-DMP/32   │   │   │   │   │   │   │                                   │
  487. │ EDITING      │   │   │   │   │   │   │                                   │
  488. ───────────────────────────────────────────────────────────────────────────-
  489.  
  490. Note : When the module to be played is bigger than 500k, Automatic mode calls
  491.        DMP for playing it.
  492.  
  493.  
  494. 1.4. Pictures files
  495.      --------------
  496.  
  497. MultiPlayer can display some popular image format and animation file if there
  498. is enough extended memory installed in your system.
  499.  
  500. - GIF : this is one of most popular formats on personal computers. Only GIF87
  501.         256-color format can be loaded by MultiPlayer.
  502. - PCX : this is the ZSoft's  PaintBrush image format. Multiplayer cannot show
  503.         4-color or 16-color images.
  504. - SCI : this is the ColorRIX (VGA Paint) 256-color image format. You can find
  505.         several images with .SCX or .RIX extension too, but you should rename
  506.         them to .SCI, else, Multiplayer will not find them.
  507. - DMP : format created by W. van Leijer. A public-domain grabber (VGAGRAB) is
  508.         available.
  509. - HS2 : it's a  simple bitmap format created by Postering,  a graphic utility
  510.         for Handy Scanner 2000.  Some HS2 file can be found on cs.uwp.edu mu-
  511.         sic archives.
  512. - PIC : format created by Kai Rohrbacher, for his AniVGA programming package.
  513.         It shouldn't be confused with ZSoft's PC-Pictor or IBM StoryBoard Li-
  514.         ve PIC format. A palette file must be stored near PIC file. It should
  515.         have same image file  name, but with a .PAL extension. PIC images can
  516.         be compressed by HUC,  a Huffman Coder compressor available in public
  517.         domain. In this case, MultiPlayer recognizes automatically compressed
  518.         images (they've .PIC extension too), and it can unpack them in memory
  519.         without using disk for decompression.
  520. - FLI : animation sequence file format created and used by Autodesk Animator,
  521.         and many other software products. You must load a FLI from a fast I/O
  522.         source only (not floppy disks).
  523.  
  524.  
  525. 1.5. Text files
  526.      ----------
  527.  
  528. Multiplayer can show raw-text files in a window, having a .TXT or a .DOC ext-
  529. ension. 'Raw-Text files' expression mean that you CANNOT show a formatted do-
  530. cument (for example if written by using Microsoft Word) or a binary file.
  531.  
  532.  
  533. ┌────────────────────────────────────────────────────────────────────────────┐
  534. │                                                                            │
  535. │                        2. MULTIPLAYER INSTALLATION                         │
  536. │                                                                            │
  537. └────────────────────────────────────────────────────────────────────────────┘
  538.  
  539.  
  540. 2.1. Hardware Required
  541.      -----------------
  542.  
  543. For a correct working, Multiplayer version 3.0 needs of:
  544.  
  545. - a PC-IBM 386/486,  or compatible. 286 is not supported anymore. If you have
  546.   a PC-286, you can use MPLAY.EXE (the MultiPlayer's command line version).
  547. - DOS 3.30 or upper. CONFIG.SYS file must have FILES = 20 (or more).
  548. - a VGA card supporting the 13h display mode (320x200, 256 colors). It's nee-
  549.   ded for displaying images or animations.
  550. - 2 MB RAM (640k base memory+1.2 MB Extended or Expanded Memory), 4 MB or mo-
  551.   re recommended. You should have a memory manager  installed (HIMEM, EMM386,
  552.   QEMM or 386MAX). Expanded memory is used when Multiplayer's kernel uses its
  553.   overlays, when a image is displayed, or a sample is played. You need enough
  554.   memory to load images or samples ENTIRELY into expanded memory. Music modu-
  555.   les  don't  use  extended  memory,  so  they  cannot  be  bigger than  free
  556.   conventional memory. Generally, a music module should be smaller than 450k.
  557.   Anyway, you can increase this limit if you have a video memory manager like
  558.   Quaterdeck's  VIDRAM  utility  (included in the QEMM386 memory manager): if
  559.   you install it, you will have 64k more available memory, but you cannot use
  560.   VGA graphic display for 28-43-50 line display mode, and for showing images.
  561. - a hard disk. 1.3MB free space is  needed for a full installation, and about
  562.   1MB free space during MultiPlayer execution (for disk swapping, or tempora-
  563.   ry files).
  564. - a sound device, one of that described below.
  565. - LHA, PKUNZIP, PAK, SQZ or ARJ located in your <PATH> statement, in order to
  566.   unpack corresponding archives.
  567. - a mouse (you must have MOUSE.COM driver loaded before you run MultiPlayer).
  568.  
  569. WARNING! MultiPlayer doesn't work, or it works badly if:
  570.  
  571. - you have a 8086, 80186 or 80286 based machine. Actually, most of the Multi-
  572.   Player sound routines are written  in 80386 assembly language, for a better
  573.   sound quality. If you have a 80286, you can use only MPLAY, the Multiplayer
  574.   command line player.
  575. - you run it under Microsoft Windows 3.00 or 3.10, when it is executed in 386
  576.   Enhanced Mode, or in a OS-2 2.1 DOS Window. There could be an ugly conflict
  577.   between Windows 3.1 SoundBlaster drivers and MultiPlayer's sound handling.
  578. - you have a write-delayed disk cache installed (SmartDrive, HyperDsk, and so
  579.   on). Please disable it when you use MULTIPLAYER! During some disk  swapping
  580.   operation, an enabled disk cache can have conflict with module data present
  581.   in memory, resulting in some trouble when you make access to disk or an au-
  582.   tomatic reboot after or before you return to DOS.
  583.  
  584.  
  585. 2.2. Sound Devices
  586.      -------------
  587.  
  588. MULTIPLAYER can use one of following sound devices, if they're recognized:
  589.  
  590.   a)  PC Speaker is supported, but it's not recommended, due to its low sound
  591.       quality: anyway,  some Amstrad PC has a good  internal speaker,  with a
  592.       volume pad, so, if you have one of these PCs, you can use MultiPlayer's
  593.       PC-Speaker support.
  594.   b)  Adlib Synthetizer Card. Quality is not good on this card: volume is ve-
  595.       ry low, so you should pump up the HI-FI's amplifier volume for a better
  596.       sound.
  597.   c)  Creative Labs' Sound Blaster 1.x, 2.x, Sound Blaster PRO, or Sound Bla-
  598.       ster ASP 16 (or all compatible sound cards, of course). DMA is used for
  599.       Standard and Pro Sound Blasters, only DMA mode is supported. Sound Bla-
  600.       ster ASP 16 is supported in  PRO emulation mode in most  of the  cases,
  601.       with some enhancement depending from current playing mode. SoundBlaster
  602.       compatible cards (for example, Sound Galaxy) should work correctly, but
  603.       they were not tested. If MULTIP.CFG configuration file is not found  in
  604.       the MultiPlayer directory,  SoundBlaster I/O address  is  automatically
  605.       detected; anyway, you can choose it from Devices Menu.
  606.   d)  Covox or compatible cards, including Covox LPT1 Interfaces, Walt Disney
  607.       Sound Source, DWY interfaces and SoundMaster ][. You can build a simple
  608.       Covox digital-analog converter for your parallel ports, by using one of
  609.       the electrical schemes reported at the bottom of this documentation. It
  610.       can be connected to LPT1 or LPT2, or any compatible port.  If you build
  611.       a Covox Stereo board,  you should connect  to  two different ports (for
  612.       example, LPT1 and LPT2). In all cases you must configure your Covox  by
  613.       inserting port addresses in the Device Menu (see above).
  614.   e)  Pro Audio Spectrum Plus or 16 card.  This device is available in Advan-
  615.       ced and DMP mode.
  616.   f)  Gravis UltraSound. This device is available in DMP mode only.
  617.   g)  Aria Sound Card. This device is available in Advanced Mode or DMP mode.
  618.   h)  Microsoft Windows(tm) Sound System. Available in DMP mode only.
  619.   i)  A special device supported from release 1.20 is the FILE DEVICE. If you
  620.       select it as default device, Module will be played on a raw sample file
  621.       called like module but with RAW extension. Be careful when you use this
  622.       device, because output file can require a lot of disk space. Songs cre-
  623.       ated can be played by using the Multiplayer's internal sample player or
  624.       some external player, like RAWPLAY, provided in this package.  A sample
  625.       shouldn't be bigger than the  expanded  memory amount available on your
  626.       system, else you should use other kind of players. If you want to use a
  627.       VOC player (like VPLAY, utility  provided with all  SoundBlasters), you
  628.       should convert your sample to a VOC file, by using a conversion program
  629.       (for example, SOX or VOC-HDR). You must set some parameters: 8-bit sam-
  630.       ple and the sampling rate set to the frequency mix rate used during mo-
  631.       dule playback. If you specify a different value,  sample will be played
  632.       at a different speed.
  633.  
  634. If you have a monophonic Sound Blaster Card and a Covox, you can play modules
  635. in a great stereo sound (by choosing the Covox+SoundBlaster option in the Se-
  636. tup Menu). If you seethe sound quality is very different in the Sound Blaster
  637. Card and in the Covox, the only way you have for improving sound is to change
  638. equalization manually on your HI-FI system.
  639.  
  640. Following table shows sound devices, as they are recognized by playing modes:
  641.  
  642. ─────────────────────────────────────────────────────────────────────────────
  643. │DEVICE               │  CLASSIC  │ ADVANCED │  AUTOMATIC  │  DMP  │  EDIT  │
  644. ─────────────────────────────────────────────────────────────────────────────
  645. │PC Speaker           │     X     │          │      X      │   X   │        │
  646. │Adlib                │     X     │          │      X      │       │        │
  647. │Covox DAC            │     X     │          │      X      │   X   │        │
  648. │SoundBlaster         │     X     │    X     │      X      │   X   │    X   │
  649. │SoundBlaster Pro     │     X     │    X     │      X      │   X   │        │
  650. │Covox+SoundBlaster   │     X     │          │      X      │       │        │
  651. │Pro Audio Spectrum   │           │    X     │      X      │   X   │        │
  652. │SoundBlaster ASP 16  │     X     │    X     │      X      │   X   │        │
  653. │Gravis UltraSound    │           │          │      X      │   X   │        │
  654. │Windows Sound System │           │          │      X      │   X   │        │
  655. │Aria Sound Card      │           │    X     │      X      │   X   │        │
  656. │Raw Sample File      │     X     │          │      X      │       │        │
  657. ─────────────────────────────────────────────────────────────────────────────
  658. (*) note : Classic-Graph Mode works with all devices used by Classic Mode.
  659.            DMP/32 Mode doesn't work with Speaker, Covox and Aria cards.
  660.  
  661.  
  662. 2.3. Setup and running.
  663.      ------------------
  664.  
  665. MultiPlayer must be installed by running  the SETUP.EXE  application.  In the
  666. public  version, Multiplayer installation files were compressed in a ZIP file
  667. (usually named MULTPxxx.ZIP,  where <xxx> is current version number).  Unpack
  668. this file into a 1.44MB diskette and run SETUP. It will expand all files in a
  669. directory on your hard disk, then  can update your AUTOEXEC.BAT, according to
  670. your choices. But, you can make your updates manually as reported below.
  671. The Multiplayer's public  version needs about  1.3Mb free  space on your hard
  672. disk, including documentations, utilities and some examples.
  673. Another version, is available FREELY via the author. It includes a second di-
  674. skette containing Dual Module Player v2.86, Dark Tracker Package and 900kb of
  675. additional examples (songs, samples, animations and pictures).
  676.  
  677. After the installation has been completed, a manual update for your AUTOEXEC.
  678. BAT could be necessary for a correct Multiplayer working.
  679.  
  680. - Modify your <PATH> statement by adding  directory where  you have installed
  681.   MultiPlayer. Reboot your PC for making these changes actived.
  682. - Set a TMP variable in your DOS environment space to a value, indicating the
  683.   directory where temporary files must be put (i.e., the songs extracted from
  684.   compressed archives, or the swapping files created by overlays and external
  685.   programs).
  686. - Set a MPMODDIR variable, where Multiplayer looks for module files the FIRST
  687.   time it will be executed.
  688.  
  689. You can run Multiplayer by typing MULTIP followed by some parameters:
  690.  
  691.                   MULTIP [/rows] [/m] [/pro] [/?] [/option]
  692.  
  693. rows can be 25, 28, 43 or 50: it specifies number of screen lines you wish to
  694. use on your desktop. Remember to use a slash (/) before number.
  695. If you have a monochrome or a Color Graphics Adapter (CGA), the value you can
  696. choose is 25. If you have an EGA card, you can choose 25 or 43. If you have a
  697. VGA card,  you can use all values, except 43. For example, if you want to use
  698. a 50 line display on your VGA you should type:
  699.  
  700.                                MULTIP /50
  701.  
  702. As first parameter, you can also specify following options:
  703.  
  704. /m   : for monochrome cards (MDA, Hercules, Olivetti)
  705. /pro : supported for compatibility  with older  Multiplayer releases, has  no
  706.        effect in this version.
  707. /?   : shows a quick help about possible command-line options.
  708.  
  709. The first parameter can be specified directly in the MPENV environment varia-
  710. ble, for example:
  711.  
  712.                              SET MPENV=/50
  713.  
  714. lets Multiplayer to be ran in 50 line display mode, unless you specify a dif-
  715. ferent parameter on the command line. MPENV can be installed by SETUP program
  716. or by yourself. If command-line and MPENV variable are both null, Multiplayer
  717. will start using a 25 line display.
  718.  
  719. You can specify other options after first parameter:
  720.  
  721. /ni    : skips the animated intro.
  722. /noxm  : doesn't check if enough expanded or extended memory is present:  so,
  723.          you can run Multiplayer also if you've only 640k memory  (but images
  724.          cannot be displayed, and samples cannot be played!)
  725.  
  726.  
  727.  
  728. ┌────────────────────────────────────────────────────────────────────────────┐
  729. │                                                                            │
  730. │                          3. MULTIPLAYER'S DESKTOP                          │
  731. │                                                                            │
  732. └────────────────────────────────────────────────────────────────────────────┘
  733.  
  734.  
  735. 3.1. Main Desktop
  736.      ------------
  737.  
  738. After a short graphic animation is displayed, a text-based  desktop will take
  739. place on the screen. You can see a menu with three options, at the top of the
  740. screen.
  741.  
  742.  
  743.       File  │  Setup  │  Devices  │  MIDI
  744.  
  745.  
  746. You can open submenus, or perform some operation by pressing some key sequen-
  747. ce directly, like reported in the following table:
  748.  
  749.  
  750. <F1> to load and display this manual.
  751. <F3> to display the file selection window (file requester).
  752. <F8> to display the lzmod filter requester.
  753. <F9> to display soundblaster's mixer control panel window.
  754. <Alt-F> to open File submenu.
  755. <Alt-S> to open Setup submenu.
  756. <Alt-D> to open Device submenu.
  757. <Alt-M> to open MIDI submenu.
  758. <Alt-X> or <ESC> to exit.
  759. <Alt-1> to switch current mode to the classic mode.
  760. <Alt-2> to switch current mode to the classic/graph mode.
  761. <Alt-3> to switch current mode to the advanced mode.
  762. <Alt-4> to switch current mode to the automatic mode.
  763. <Alt-5> to switch current mode to the dmp mode.
  764. <Alt-6> to switch current mode to the editing mode.
  765.  
  766. *WARNING* : some key depends from  the message language utilized. Usually,  a
  767.             menu option is selected by pressing the <ALT> key followed by the
  768.             FIRST option letter.
  769.  
  770.  
  771. When a submenu is opened, you can select a particular option, by using cursor
  772. keys (up and down) or moving the mouse pointer, and pressing <Enter> (or left
  773. mouse button) on your favorite choice. You can close a submenu by hitting ESC
  774. key or right mouse button.
  775.  
  776. All submenu options are described in next sections.
  777.  
  778.  
  779. 3.2. File Menu
  780.      ---------
  781.  
  782. <Load modules and play>
  783.   Actually, this is the most important option in this version of MultiPlayer.
  784.   It's available by pressing <F3> key too. A file requester will appear.  Se-
  785.   lect the  files you  want to play (or view) by pressing  <Space> bar,  then
  786.   press <F10> when you want to play them.  Up to  700 different  files can be
  787.   selected in a directory. If you want to select a file in the current direc-
  788.   tory,  you can specify the file name (or a part of it), by  pressing <Tab>.
  789.   Also, you can press <Enter> key on a directory name to make it the current,
  790.   <Alt-D> to open device selection menu, or <Esc> to leave file requester wi-
  791.   thout playing the selected modules and return to desktop. If you press <En-
  792.   ter> on a file, all the others will be unselected and the current file will
  793.   be processed. You can choose files  from the request  window directly,  but
  794.   you can select compressed archives too (ARC, ZIP, PAK, LZH, SQZ or ARJ for-
  795.   mats): in this case, if your system  has the  corresponding unpack  utility
  796.   installed in <PATH> statement, you can select a file (only one) included in
  797.   the archive, by using another requester,  showing all files included in the
  798.   archive).  After you pressed <Enter> key, MultiPlayer  will run  the unpack
  799.   program needed for unpacking selected file. Depending on the TMP environmnt
  800.   variabile, the  module will be  unpacked in a temporary directory,  played,
  801.   then it will be removed from hard disk.  See notes reported below for  some
  802.   informations about file dearchivers.
  803.  
  804. <Use LZMOD Archive>
  805.   Similar to previous option, but it doesn't display a file requester working
  806.   on the current directory, but looks for an archive, called LZMODARC, placed
  807.   in a directory stored in your PATH statement. LZMODARC is a file created by
  808.   the LZMOD program, a database management system  allowing you to store your
  809.   modules automatically, by using its true name (that is, the song name)  and
  810.   a LZH archive name  (where the module is stored).  The LZMODARC file format
  811.   looks like a sequence compound by C structures, like follows:
  812.  
  813.       struct archive_record {
  814.             unsigned short title_length; /* it's always 25 */
  815.             char dummy[5];               /* it should be five spaces */
  816.             char title[20];              /* module title, or description */
  817.             unsigned short name_length;  /* it's always 12 */
  818.             char name[12];               /* module's file name */
  819.             unsigned short num_length;   /* it's always 10 */
  820.             char length[10];             /* string containing the module
  821.                                             length */
  822.             unsigned short arcn_length;  /* put it always to 12 */
  823.             char archive_name [12];      /* archive name, where the module
  824.                                             is stored */
  825.       }
  826.  
  827.   Note for C programmers: the 'char' definitions refer to not-null-terminated
  828.   strings. Write to the author for further informations about LZMOD.
  829.   You can select one of the LZMODARC record directly from the file requester,
  830.   or by specifing its name (see previous option for instructions for the file
  831.   requester usage). After a file is selected, Multiplayer looks for the right
  832.   archive in all drives until a diskette containing it, will be inserted into
  833.   any disk drive. Then, Multiplayer works in the same way the previous option
  834.   does. LZMOD archive is entirely  shown,  unless you've selected a filter in
  835.   the 'LZMOD filter' option (see section 3.3).
  836.  
  837. <Output Device>
  838.   You can choose the sound device to be used.  Depending from current playing
  839.   mode, a reduced list of possible sound devices is available.  All unavaila-
  840.   ble sound cards are grayed.
  841.  
  842. <Playing Mode>
  843.   allow you to select a playing mode.  See above for a full explanation about
  844.   all playing modes.
  845.  
  846. <About Multiplayer>
  847.   shows the introduction window. Press <Enter> to exit.
  848.  
  849. <System Information>
  850.   give some informations about your current system configuration: processors,
  851.   graphic and sound cards, all informations about memory and so on.
  852.  
  853. <Dos Shell>
  854.   executes a secondary command processor. Multiplayer swaps itself to the Ex-
  855.   tended or Expanded memory, if they're found on your system,  or on the hard
  856.   disk, if no  enough memory is available for swapping.  In this  case, about
  857.   600k disk space must be available.  Due to this swapping,  your system will
  858.   have a lot of DOS memory free space for executing applications.  Don't load
  859.   TSR programs, or the system can crash. Type EXIT at the DOS prompt in order
  860.   to come back to the Multiplayer's desktop.
  861.  
  862. <Exit>
  863.   end the Multiplayer session and go to DOS. A dialog box will appear and let
  864.   you confirm this operation.
  865.  
  866.  
  867. Note 1 : The  MPMODDIR  environment variable can  change  the file  requester
  868.          behaviour. If it's set to a particular directory, the file requester
  869.          make this directory the current one. If MPMODDIR variable doesn't e-
  870.          xist, it uses by default the current DOS directory.
  871.  
  872. Note 2 : Following extract utilities are needed, for unpacking the compressed
  873.          archives (they must be installed in your system's PATH variable):
  874.          - LHA.EXE release 2, for LZH or LHA files.
  875.          - PKUNZIP.EXE release 0.9 to 2.0, for ZIP files.
  876.          - PAK.EXE release 2.50 (by NoGate Consulting), for PAK or ARC files.
  877.          - ARJ.EXE release 2, for ARJ files.
  878.          - SQZ.EXE release 1.08, for SQZ files.
  879.  
  880.  
  881. 3.3. Setup Menu
  882.      ----------
  883.  
  884. <Frequency Mix Rate>
  885.   allows you to select a change the frequency mixing rate. A higher frequency
  886.   mix rate means a better sound quality, but needs a faster computer. Default
  887.   value are 16000Hz for the Classic Mode, and 22000Hz for Advanced or DMP Mo-
  888.   de. Editing mode selects a  frequency mixing speed automatically, depending
  889.   on the computer speed. If you've a fast PC,  and the actual playing mode is
  890.   set to Classic, you can try to increase the frequency but you should be ca-
  891.   reful. If frequency is too high your system can crash.  A best sound device
  892.   allows higher frequency values. In all playing modes, you can set frequency
  893.   rate up to 16000Hz for a SoundBlaster, 22000Hz for a SoundBlaster Pro,44000
  894.   Hz for Gravis UltraSound Card, Pro Audio Spectrum or SoundBlaster ASP 16.If
  895.   you use the PC Speaker or a Covox DAC, you shouldn't exceed 10000 Hz,   due
  896.   to hardware  limitations  (on my 386sx/25, when a SoundBlaster-Covox couple
  897.   is choosen, Multiplayer is not able to select a frequency rate greater than
  898.   8500Hz). You can use the WHICH utility to know what is the optimum frequen-
  899.   cy rate allowed by your sound card.
  900.  
  901. <Initial volume>
  902.   selects initial playing volume. Classic Mode allows you to set a volume ra-
  903.   te in the range 0..255, while in the Advanced and DMP Modes volume can vary
  904.   from 0 to 64.
  905.  
  906. <Fade Speed>
  907.   the 'fade out' speed used when you press 'N' during a module playback.
  908.  
  909. <Loop Module>
  910.   if this option is switched to YES, a module will be rewound and played back
  911.   again, each time it reaches its end, else it will be played back only once,
  912.   unless it has an internal Jump command  ('B'  event in Protracker  modules)
  913.   simulating the loop.
  914.  
  915. <Mono Mode>
  916.   in Classic Mode,allows most of 4-Channel Modules (NoiseTracker, ProTracker,
  917.   StarTrekker, Scream Tracker 2.0 and ModEdit) and 699 Composer's Modules  to
  918.   be played in mono on  all stereo devices (Covox+SoundBlaster included), but
  919.   the volume and  the  sound quality decrease slightly.  In Advanced Mode, it
  920.   works on any kind of module,  but your card should have a stereo/mono regi-
  921.   ster (e.g. SoundBlaster PRO).
  922.  
  923. <Spatial Sound>
  924.   this is a specific MultiPlayer feature! This option available only in four-
  925.   Channel Modules and only when Classic Mode is selected, allows module to be
  926.   played in enhanced 3D-Stereo (on stereo devices).  When option is  enabled,
  927.   MultiPlayer puts channel 1 and 2 on both device DACs, while voice 3 will be
  928.   played on DAC connected  to left  device, and voice 4 will be played on the
  929.   right device.  Advanced and  DMP modes don't need this option, because they
  930.   have an internal mechanism allowing you to 'pan' channels through both ste-
  931.   reo sides (see below).
  932.  
  933. <Save Memory Space for Mods>
  934.   enable or disable the Low Quality Mode.  In Classic Mode,  when this option
  935.   is setted to YES,memory needed for module is reduced to about 50%. A module
  936.   bigger than 430k can be played easily, also if the sound quality is not ve-
  937.   ry good. If the option is  setted to NO,  you need more memory for a module
  938.   but the sound quality is better.  Anyway,  this option does  not affect all
  939.   modules. Protracker mods are not modified by this option, while Scream Tra-
  940.   cker 3.0 modules will be improved considerably when the option  is enabled.
  941.   In Advanced (or DMP Mode),  this option enables (or disables)  an  enhanced
  942.   quality mode support for 8-bit cards (SoundBlaster v1.5 or Pro) and removes
  943.   all unused patterns and samples from memory during module loading.
  944.  
  945. <User Panning>
  946.   this option can work with Advanced Mode only. When it's switched to YES,you
  947.   can use your own panning table,  as you can configure by using the <Panning
  948.   Control Panel>.  If this option is switched to NO,  a default panning table
  949.   will be used for playback.
  950.  
  951. <Channels>
  952.   let you set the maximum channels a module can play simultaneously. This op-
  953.   tion is useful for improving sound quality when  you play  modules having a
  954.   fixed  (and high) channel number in it.  For example,  Protracker Studio 16
  955.   (P16) modules has no informations about channel number stored into  them so
  956.   fixed value is 16.  But this value is too high for a good quality,  even if
  957.   module uses less than 16 voices.  So,  if you set maximum channel to 4, you
  958.   improve the  sound quality  a lot, but, if module has more than 4 channels,
  959.   some voice is not played back. Listen to the module before setting this op-
  960.   tion. If AUTO is selected for Channels option,  no modifications on channel
  961.   number will be made. This option can be used in Classic Modes only.
  962.  
  963. <MIDI Player>
  964.   let you choose a player for standard MIDI files. Two players are available:
  965.   PLAYMIDI, the Creative Labs MIDI Player,  and Midi Master,  a public domain
  966.   player  (included in the Multiplayer's package).  Both programs can use the
  967.   General MIDI instrument patch. Drums are mapped according to the MT-32 drum
  968.   patch.
  969.   PLAYMIDI needs of SBMIDI driver installed, and supports SoundBlaster Pro 2,
  970.   ASP 16, or Multi-CD sound cards. It can use internal synthetizer chips, MI-
  971.   DI OUT port or MPU-401 interface, according to options utilized when SBMIDI
  972.   driver is loaded. You can configure PLAYMIDI for working with General, Ext-
  973.   ended or Basic MIDI.  PLAYMIDI doesn't  work with SoundBlaster 1.x, 2.x, or
  974.   Pro v1.
  975.   Midi Master is a program written by Cornel Huth, based on Ruckus' SoundCard
  976.   Toolkit. It works with Gravis UltraSound, and all SoundBlaster cards having
  977.   OPL chips; the most important thing is: no external driver is needed. Gene-
  978.   ral, Extended or Basic MIDI files can be played.Gravis Ultrasound users can
  979.   change instrument patch by using patch files provided with Gravis disks.
  980.   Anyway, Midi Master is a beta-test program (v0.20), so, it could have trou-
  981.   bles on some  MIDI files (especially if these files are  bigger than  64k),
  982.   crashing or resetting your  system; but, if QEMM386 is installed,  a system
  983.   exception can occur, resulting in a display scroll due to an invisible mes-
  984.   sage shown by QEMM386. In this case,if PC seems to be blocked, try to press
  985.   'T' key (for 'T'erminate process). If nothing happens, switch your computer
  986.   off. If the process termination is successful, you will see the Multiplayer
  987.   screen again. However I hope the Midi Master author will release a bug-free
  988.   version soon... :-)
  989.   MIDI players can be configured by using MIDI Menu. See section 3.5 for full
  990.   details.
  991.  
  992. <Graphic Image>
  993.   allows you to select the image to  display on the graphic desktop, when you
  994.   use the 'Classic/Graph' playing mode. Only PIC format images can be used. A
  995.   request window will appear. If you pressed ESC, no image will be selected.
  996.  
  997. <LZMOD Filter>
  998.   let you choose a particular set of modules from LZMOD archives, in the 'Use
  999.   LZMOD Archive' option.  A requester will  appear.  Select a module type and
  1000.   press <Enter>. If you press <Esc>, all files will be shown when you consult
  1001.   the LZMOD archive. A filter is useful, if you want to search for a specific
  1002.   set of module types in your module database.
  1003.  
  1004. <Panning Control Panel>
  1005.   let you create a new panning table, to use with Advanced Playing Mode. Pan-
  1006.   ning gives you the possibility to  choose channel position on an  amplifier
  1007.   side. Select the channel to pan  with <up>  and <down>  arrows, then change
  1008.   panning by pressing <left>  and <right> arrows (moving highlited  bar).  If
  1009.   bar is on the left, the corrispondent channel will be totally played on the
  1010.   left side.  If bar is on the right, it will be played on the right side. It
  1011.   is possible to choose intermediate values: a negative number indicates that
  1012.   a channel will be  put mainly on  the left side,  but also on the right.  A
  1013.   null value allows a channel to be put on both side with same intensity. 'L'
  1014.   key puts a channel totally on the left. 'R' put it totally on the right,'M'
  1015.   puts it on the middle. 'C' puts all channels  on the middle side, 'D'  sets
  1016.   all values to  the default one. You can  exit from Panning Control Panel by
  1017.   pressing <ESC> key.
  1018.  
  1019. <Default values>
  1020.   if you select this option, all parameters setted by setup menu will be bro-
  1021.   ught back to the default values (that is, the values setted by  MultiPlayer
  1022.   internally). Sound Card Settings will not be changed by this option.
  1023.  
  1024.  
  1025. Note 1 : All parameters  configured by  Setup Menu will be saved on disk in a
  1026.          text file called MULTIP.CFG when you exit from menu. This file  will
  1027.          be loaded automatically when you restart MultiPlayer. You can modify
  1028.          the configuration file manually,  by using a simple text editor, but
  1029.          be careful when you do it.
  1030.  
  1031. Note 2 : This menu has no effect on FM music and on VOC playback.
  1032.  
  1033.  
  1034. 3.4. Devices Menu
  1035.      ------------
  1036.  
  1037. <Covox Left I/O Address>
  1038.   allows you to choose the  I/O  Port  address  where a Covox (or compatible)
  1039.   device is installed.  If current output device  is  setted to Covox Stereo,
  1040.   this parameter  can be used  to choose  left  device (well, of  course, you
  1041.   should put the Covox plug into left side of your amplifier).If current out-
  1042.   put device is setted to  Covox Mono, or Covox+SoundBlaster, use this option
  1043.   in  order to modify the Covox I/O port address. You can put decimal or hex-
  1044.   adecimal numbers in input field,  by putting a  'h' after the number, (e.g.
  1045.   0408h). When you use a digital-analog converter plugged into LPT1, you must
  1046.   specify 0378h. When it's plugged into LPT2, you must write 0278h.
  1047.  
  1048. <Covox Right I/O Address>
  1049.   allows you to set the I/O Port address where a Covox or compatible card  is
  1050.   installed in order to be used as a right device (if its plug  is  connected
  1051.   to right side of your amplifier, of course).  This option must be used only
  1052.   when the Covox Stereo Device is choosen (in the output device menu option).
  1053.   See above for information about port values.
  1054.  
  1055. <SoundBlaster Settings>
  1056.   invokes a submenu,  allowing you  to select  all hardware  parameters for a
  1057.   SoundBlaster (or compatible) card: that is the I/O Address (possible values
  1058.   are 210h, 220h, 230h, 240h, 250h or 260h), the Interrupt Line (0 to 7), the
  1059.   DMA channel  (0 to 3). Also,  you can let Multiplayer to  detect parameters
  1060.   automatically  by selecting 'Autodetect' option,  or use the  values stored
  1061.   into the BLASTER environment variable, if the 'BLASTER' option is selected.
  1062.   Warning: a wrong value for some parameter can cause your PC to crash or re-
  1063.   boot automatically.
  1064.  
  1065. <SoundBlaster Pro Mixer>
  1066.   shows the mixer control panel window. This option assumes you have a Sound-
  1067.   Blaster Pro card,  so your system can crash if  you choose this  option and
  1068.   the SoundBlaster PRO is not installed or properly configured. For  complete
  1069.   instructions, read section 4.3.
  1070.  
  1071.  
  1072. 3.5. MIDI Menu
  1073.      ---------
  1074.  
  1075. This menu allows you to modify configuration for PLAYMIDI or Midi Master pro-
  1076. grams.  Options will be saved on MULTIP.CFG,  but the 'Default Values' option
  1077. in the Setup Menu will not be able to restore original values.
  1078.  
  1079.  
  1080. <FM Device>                                                     *MIDI MASTER*
  1081.   It tells MIDI MASTER which  FM chips should be used for playing MIDI files.
  1082.   If a SoundBlaster is installed, possible choices are <2> if you want to use
  1083.   OPL2 chips, or <3> for using the  OPL3 chips. For Gravis  UltraSound users,
  1084.   the only available option is <5>.
  1085.  
  1086. <Volume Response>                                               *MIDI MASTER*
  1087.   Choose the volume response type  for playing your MIDI files. <1>  means  a
  1088.   linear response, <0> a logarythmic response.  Most MIDI files can be played
  1089.   in linear mode, even if they're log-based.
  1090.  
  1091. <4op Voices>                                                    *MIDI MASTER*
  1092.   Number of 4op chips utilized by MIDI MASTER during playback. Possible valu-
  1093.   es are in the range [0,6]. Default value is 0.
  1094.  
  1095. <LFO Effects>                                                   *MIDI MASTER*
  1096.   It specifies what LFO effects to  use. <1> selects FM vibrato.  <2> selects
  1097.   AM vibrato. <3> selects both effects.
  1098.  
  1099. <Drum Channel>                                        *MIDI Master, PLAYMIDI*
  1100.   It specifies MIDI channel to use for drum patch. Default is 10.
  1101.  
  1102. <Patch Quality>                                                 *MIDI MASTER*
  1103.   <0> value loads all required patches, in original form (16-or 8-bit, whate-
  1104.   ver it is). <1> loads all patches in low-resolution form.
  1105.  
  1106. <Timer>                                                         *MIDI MASTER*
  1107.   force MIDI Master to use a specific timer.  <0> uses the PC timer, <1> uses
  1108.   the sound card's internal timer.
  1109.  
  1110. <Music Volume>                                                  *MIDI MASTER*
  1111.   let you choose the global volume for MIDI files. Possible values are in the
  1112.   range [0,100]. Values can differ for linear or logarythmic volume modes.
  1113.  
  1114. <WDS Adjust>                                                    *MIDI MASTER*
  1115.   it works on Windows dual-sequence MIDI files only. If this option is set to
  1116.   <0>, the device capabilities are consuled to know what sequence to play, if
  1117.   extended (channels 1-10) or basic  (channels 13-16). <1>  forces the basic-
  1118.   sequence channel playing, <2> forces the extended-sequence channel playing.
  1119.  
  1120. <Voices>                                                        *MIDI MASTER*
  1121.   change the maximum number of voices to play, in the range [1,32].  Optimum
  1122.   value is 32; if a lower value is specified, some voice can be muted during
  1123.   playback.
  1124.  
  1125. <Default Patch>                                       *MIDI Master, PLAYMIDI*
  1126.   Select what patch to use  (for Gravis UltraSound only).  Value should be in
  1127.   the range [0,127], indicating what patch to use. Default is <0>, indicating
  1128.   the acoustic piano patch. A value greater than 127, causes no default patch
  1129.   will be used. If PLAYMIDI player is selected (see Setup Menu),  this option
  1130.   selects Extended (0), Basic (1) or General (2) MIDI patches.
  1131.  
  1132.  
  1133.  
  1134.  
  1135. ┌────────────────────────────────────────────────────────────────────────────┐
  1136. │                                                                            │
  1137. │                               4. PLAYBACK                                  │
  1138. │                                                                            │
  1139. └────────────────────────────────────────────────────────────────────────────┘
  1140.  
  1141.  
  1142. 4.1. MultiPlayer windows
  1143.      -------------------
  1144.  
  1145. Now let's see what MultiPlayer shows during module playback.
  1146.  
  1147. During playback, MultiPlayer's Desktop shows two windows. the first, smaller,
  1148. placed at the screen top, shows information about module currently played:
  1149.  
  1150.  
  1151. ------------------------------------------------------------------------------
  1152. Module Name: Debbie Gibson Remix      Tempo: 006    Frequency Rate: 12000 Hz
  1153. Track      : 001/024/012 (001)        BPM  : 125    Filter On     : 1
  1154. Format     : NoiseTracker/ProTracker                Filter Off    : 2
  1155. Device     : #12:Covox+SoundBlaster                 Equalizer     : ON
  1156. Volume     : ████                  015              Looping       : ON
  1157. ------------------------------------------------------------------------------
  1158.  
  1159.                        Figure #1: The Information Window
  1160.  
  1161.  
  1162. At the  top-left side,  you can see internal module name,  track informations
  1163. (current pattern, total patterns, current row, current pattern number), modu-
  1164. le format, device name, current volume, current tempo, beats per minute, cur-
  1165. rent frequency mix rate, filter settings, equalizer switch and a switch indi-
  1166. cating if module has to be looped).
  1167.  
  1168. The second window displays animated bars, pattern partitures, samples or help
  1169. according to mode currently selected by function keys (see below). An example
  1170. reported below shows the 'bar' mode:
  1171.  
  1172.  
  1173. ------------------------------------------------------------------------------
  1174. 01  BassDrum                      E-2             048 -  L
  1175. 02  Chorus                        C-3                 024 -  R
  1176. 03  Electric Guitar               A-2         024 42 R
  1177. 04  Pizza                         E-1               024 -  L
  1178. 05  Chorus                        C-3                 024 -  L
  1179. 06  BassDrum                      E-2             048 -  R
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187. ------------------------------------------------------------------------------
  1188.  
  1189.                            Figure #2: The Main Window
  1190.  
  1191.  
  1192. 4.2. HotKeys
  1193.      -------
  1194.  
  1195. When you play a module, you can change some effect and switch in order to mo-
  1196. dify sound reproduction, by pressing  alpha-numeric or  function keys on your
  1197. keyboard. The following table shows all keys utilized by
  1198.  
  1199. ─────────────────────────────────────────────────────────────────────
  1200. │  Keys     │ Classic         │  Classic-Graph   │  Advanced        │
  1201. │           │      Mode       │         Mode     │        Mode      │
  1202. ─────────────────────────────────────────────────────────────────────
  1203. │   F1      │   Help Page 1   │   Show or hide   │   Help Page 1    │
  1204. │           │                 │  channel numbers │                  │
  1205. ─────────────────────────────────────────────────────────────────────
  1206. │   F2      │   Help Page 2   │   Change Color   │   Help Page 2    │
  1207. │           │                 │                  │                  │
  1208. ─────────────────────────────────────────────────────────────────────
  1209. │   F3      │  Show Partiture │                  │                  │
  1210. │           │    (Ch. 1-4)    │                  │                  │
  1211. ─────────────────────────────────────────────────────────────────────
  1212. │   F4      │  Show Partiture │                  │                  │
  1213. │           │    (Ch. 5-8)    │                  │                  │
  1214. ─────────────────────────────────────────────────────────────────────
  1215. │   F5      │  Show Partiture │                  │                  │
  1216. │           │    (Ch. 9-12)   │                  │                  │
  1217. ─────────────────────────────────────────────────────────────────────
  1218. │   F6      │  Show Partiture │   Volume Mode    │                  │
  1219. │           │    (Ch. 13-16)  │                  │                  │
  1220. ─────────────────────────────────────────────────────────────────────
  1221. │   F7      │ Instrument List │ Instrument List  │ Instrument List  │
  1222. │           │                 │                  │                  │
  1223. ─────────────────────────────────────────────────────────────────────
  1224. │   F8      │    VU-Meters    │    Vu-Meters     │    Vu-Meters     │
  1225. │           │                 │                  │                  │
  1226. ────────────────────────────────────────────────────────────────────│
  1227. │   F9      │                 │  Graphic Scope   │                  │
  1228. │           │                 │                  │                  │
  1229. ─────────────────────────────────────────────────────────────────────
  1230. │   F10     │   Virtual DOS   │     Module       │   Virtual DOS    │
  1231. │           │      Shell      │  informations    │      Shell       │
  1232. ─────────────────────────────────────────────────────────────────────
  1233. │  Ctrl     │  VU-Meters      │                  │                  │
  1234. │    F1     │      Page (1)   │                  │                  │
  1235. ─────────────────────────────────────────────────────────────────────
  1236. │  Ctrl     │  VU-Meters      │                  │                  │
  1237. │    F2     │      Page (2)   │                  │                  │
  1238. ─────────────────────────────────────────────────────────────────────
  1239. │  Ctrl     │  VU-Meters      │                  │                  │
  1240. │    F3     │      Page (3)   │                  │                  │
  1241. ─────────────────────────────────────────────────────────────────────
  1242. │  Ctrl     │  VU-Meters      │                  │                  │
  1243. │    F4     │      Page (4)   │                  │                  │
  1244. ─────────────────────────────────────────────────────────────────────
  1245. │  Ctrl     │  VU-Meters      │                  │                  │
  1246. │    F5     │      Page (5)   │                  │                  │
  1247. ─────────────────────────────────────────────────────────────────────
  1248. │   Home    │ Jumps to the    │ Jumps to the     │ Jumps to the     │
  1249. │           │ song beginning  │ song beginning   │ song beginning   │
  1250. ─────────────────────────────────────────────────────────────────────
  1251. │   Left    │   Change Tempo  │   Change Tempo   │  Change Tempo    │
  1252. │ or Right  │                 │                  │                  │
  1253. ─────────────────────────────────────────────────────────────────────
  1254. │ Ctrl-Left │    Change BPM   │    Change BPM    │   Change BPM     │
  1255. │Ctrl-Right │                 │                  │                  │
  1256. ─────────────────────────────────────────────────────────────────────
  1257. │   Up      │ Change          │ Change           │                  │
  1258. │ or Down   │  Mixing Speed   │  Mixing Speed    │                  │
  1259. ─────────────────────────────────────────────────────────────────────
  1260. │  PgUp     │ Jump forwards   │ Jump forwards    │ Jump forwards    │
  1261. │ or PgDn   │   or backwards  │   or backwards   │   or backwards   │
  1262. ─────────────────────────────────────────────────────────────────────
  1263. │  1..0     │ turn on/off     │ turn on/off      │ turn on/off      │
  1264. │           │ channels        │ channels         │ channels         │
  1265. ─────────────────────────────────────────────────────────────────────
  1266. │  Alt      │                 │                  │ panning to       │
  1267. │   F1..F10 │                 │                  │   left channel   │
  1268. ─────────────────────────────────────────────────────────────────────
  1269. │  Alt      │ decrease        │ decrease         │ panning to       │
  1270. │   1..0    │ channel volume  │ channel volume   │   the middle     │
  1271. ─────────────────────────────────────────────────────────────────────
  1272. │  Alt      │ increase        │ increase         │ panning to       │
  1273. │   Q..P    │ channel volume  │ channel volume   │  right channel   │
  1274. ─────────────────────────────────────────────────────────────────────
  1275. │    C      │                 │                  │                  │
  1276. │           │                 │                  │                  │
  1277. ─────────────────────────────────────────────────────────────────────
  1278. │    D      │ save samples    │ save samples     │ save samples     │
  1279. │           │ (signum convers)│ (signum convers) │ (sgn convers)    │
  1280. ─────────────────────────────────────────────────────────────────────
  1281. │    E      │ equalizer       │ equalizer        │                  │
  1282. │           │                 │                  │                  │
  1283. ─────────────────────────────────────────────────────────────────────
  1284. │    F      │ filter cut      │ filter cut       │ soundblaster     │
  1285. │           │ freq. selection │ freq. selection  │ pro filter on    │
  1286. ─────────────────────────────────────────────────────────────────────
  1287. │    G      │ filter type     │ filter type      │ soundblaster     │
  1288. │           │  selection      │  selection       │ pro filter off   │
  1289. ─────────────────────────────────────────────────────────────────────
  1290. │    I      │ sample          │ sample           │ sample           │
  1291. │           │ informations    │ informations     │ informations     │
  1292. ─────────────────────────────────────────────────────────────────────
  1293. │    K      │                 │                  │ soundblaster     │
  1294. │           │                 │                  │ pro stereo set   │
  1295. ─────────────────────────────────────────────────────────────────────
  1296. │    L      │ turn off        │ turn off         │ turn off         │
  1297. │           │ right channels  │ right channels   │ right channels   │
  1298. ─────────────────────────────────────────────────────────────────────
  1299. │    M      │ soundblaster    │ soundblaster     │ soundblaster     │
  1300. │           │ pro mixer       │ pro mixer        │ pro mixer        │
  1301. ─────────────────────────────────────────────────────────────────────
  1302. │    N      │ song fading and │ song fading and  │ sound fading and │
  1303. │           │ load next file  │ load next file   │ load next file   │
  1304. ─────────────────────────────────────────────────────────────────────
  1305. │    P      │ pause or resume │ pause or resume  │ pause or resume  │
  1306. │           │ module playback │ module playback  │ module playback  │
  1307. ─────────────────────────────────────────────────────────────────────
  1308. │    R      │ turn off        │ turn off         │ turn off         │
  1309. │           │ left channels   │ left channels    │ left channels    │
  1310. ─────────────────────────────────────────────────────────────────────
  1311. │    S      │ save samples    │ save samples     │ save samples     │
  1312. │           │ (no sgn convers)│ (no sgn convers) │ (no sgn convers) │
  1313. ─────────────────────────────────────────────────────────────────────
  1314. │  + or -   │ increase or     │ increase or      │ increase or      │
  1315. │           │ decrease volume │ decrease volume  │ decrease volume  │
  1316. ─────────────────────────────────────────────────────────────────────
  1317. │    /      │ toggle          │ toggle           │ toggle           │
  1318. │           │ looping mode    │ looping mode     │ looping mode     │
  1319. ─────────────────────────────────────────────────────────────────────
  1320. │  < or >   │ change vu-meter │ change vu-meter  │ change vu-meter  │
  1321. │           │ bar characters  │ bar characters   │ bar characters   │
  1322. ─────────────────────────────────────────────────────────────────────
  1323. │  Enter    │                 │                  │                  │
  1324. │           │                 │                  │                  │
  1325. ─────────────────────────────────────────────────────────────────────
  1326. │  Space    │                 │                  │                  │
  1327. │           │                 │                  │                  │
  1328. ─────────────────────────────────────────────────────────────────────
  1329. │   Tab     │                 │                  │                  │
  1330. │           │                 │                  │                  │
  1331. ─────────────────────────────────────────────────────────────────────
  1332. │   Esc     │ stop module and │ stop module and  │ stop module and  │
  1333. │           │ stop sequence   │ stop sequence    │ stop sequence    │
  1334. ─────────────────────────────────────────────────────────────────────
  1335.  
  1336. ──────────────────────────────────────────────────────
  1337. │  Keys     │   CMF    │   VOC    │ Sample (RAW/WAV) │
  1338. │           │ Playback │ Playback │     Playback     │
  1339. ──────────────────────────────────────────────────────
  1340. │   F1      │  Help    │  Help    │                  │
  1341. │           │   Page   │   Page   │                  │
  1342. ──────────────────────────────────────────────────────
  1343. │   F2      │          │          │                  │
  1344. │           │          │          │                  │
  1345. ──────────────────────────────────────────────────────
  1346. │   F3      │          │          │                  │
  1347. │           │          │          │                  │
  1348. ──────────────────────────────────────────────────────
  1349. │   F4      │          │          │  Change Octave   │
  1350. │           │          │          │       (-4)       │
  1351. ──────────────────────────────────────────────────────
  1352. │   F5      │          │          │  Change Octave   │
  1353. │           │          │          │       (-3)       │
  1354. ──────────────────────────────────────────────────────
  1355. │   F6      │          │          │  Change Octave   │
  1356. │           │          │          │       (-2)       │
  1357. ──────────────────────────────────────────────────────
  1358. │   F7      │          │          │  Change Octave   │
  1359. │           │          │          │       (-1)       │
  1360. ──────────────────────────────────────────────────────
  1361. │   F8      │          │          │  Change Octave   │
  1362. │           │          │          │     (middle)     │
  1363. ──────────────────────────────────────────────────────
  1364. │   F9      │          │          │  Change Octave   │
  1365. │           │          │          │       (+1)       │
  1366. ──────────────────────────────────────────────────────
  1367. │   F10     │ Virtual  │ Virtual  │  Change Octave   │
  1368. │           │ Dos Shell│ Dos Shell│       (+2)       │
  1369. ──────────────────────────────────────────────────────
  1370. │  Ctrl     │          │          │                  │
  1371. │    F1     │          │          │                  │
  1372. ──────────────────────────────────────────────────────
  1373. │  Ctrl     │          │          │                  │
  1374. │    F2     │          │          │                  │
  1375. ──────────────────────────────────────────────────────
  1376. │  Ctrl     │          │          │                  │
  1377. │    F3     │          │          │                  │
  1378. ──────────────────────────────────────────────────────
  1379. │  Ctrl     │          │          │                  │
  1380. │    F4     │          │          │                  │
  1381. ──────────────────────────────────────────────────────
  1382. │  Ctrl     │          │          │                  │
  1383. │    F5     │          │          │                  │
  1384. ──────────────────────────────────────────────────────
  1385. │   Home    │          │          │                  │
  1386. │           │          │          │                  │
  1387. ──────────────────────────────────────────────────────
  1388. │   Left    │ set song │          │                  │
  1389. │ or Right  │  speed   │          │                  │
  1390. ──────────────────────────────────────────────────────
  1391. │ Ctrl-Left │  change  │          │                  │
  1392. │Ctrl-Right │   BPM    │          │                  │
  1393. ──────────────────────────────────────────────────────
  1394. │   Up      │ transpose│          │                  │
  1395. │ or Down   │   song   │          │                  │
  1396. ──────────────────────────────────────────────────────
  1397. │  PgUp     │          │          │                  │
  1398. │ or PgDn   │          │          │                  │
  1399. ──────────────────────────────────────────────────────
  1400. │  1..0     │          │          │                  │
  1401. │           │          │          │                  │
  1402. ──────────────────────────────────────────────────────
  1403. │  Alt      │          │          │                  │
  1404. │   F1..F10 │          │          │                  │
  1405. ──────────────────────────────────────────────────────
  1406. │  Alt      │          │          │                  │
  1407. │   1..0    │          │          │                  │
  1408. ──────────────────────────────────────────────────────
  1409. │  Alt      │          │          │                  │
  1410. │   Q..P    │          │          │                  │
  1411. ──────────────────────────────────────────────────────
  1412. │    C      │          │          │ convert sample   │
  1413. │           │          │          │     signum       │
  1414. ──────────────────────────────────────────────────────
  1415. │    D      │          │          │                  │
  1416. │           │          │          │                  │
  1417. ──────────────────────────────────────────────────────
  1418. │    E      │          │          │                  │
  1419. │           │          │          │                  │
  1420. ──────────────────────────────────────────────────────
  1421. │    F      │          │          │ soundblaster     │
  1422. │           │          │          │ pro filter on    │
  1423. ──────────────────────────────────────────────────────
  1424. │    G      │          │          │ soundblaster     │
  1425. │           │          │          │ pro filter off   │
  1426. ──────────────────────────────────────────────────────
  1427. │    I      │          │          │                  │
  1428. │           │          │          │                  │
  1429. ──────────────────────────────────────────────────────
  1430. │    K      │          │          │                  │
  1431. │           │          │          │                  │
  1432. ──────────────────────────────────────────────────────
  1433. │    L      │          │          │                  │
  1434. │           │          │          │                  │
  1435. ──────────────────────────────────────────────────────
  1436. │    M      │  sbpro   │  sbpro   │   soundblaster   │
  1437. │           │  mixer   │  mixer   │     pro mixer    │
  1438. ──────────────────────────────────────────────────────
  1439. │    N      │          │          │                  │
  1440. │           │          │          │                  │
  1441. ──────────────────────────────────────────────────────
  1442. │    P      │ pause or │ pause or │                  │
  1443. │           │  resume  │  resume  │                  │
  1444. ──────────────────────────────────────────────────────
  1445. │    R      │          │          │                  │
  1446. │           │          │          │                  │
  1447. ──────────────────────────────────────────────────────
  1448. │    S      │          │          │                  │
  1449. │           │          │          │                  │
  1450. ──────────────────────────────────────────────────────
  1451. │  + or -   │          │          │  increase or     │
  1452. │           │          │          │ decrease volume  │
  1453. ──────────────────────────────────────────────────────
  1454. │    /      │          │          │                  │
  1455. │           │          │          │                  │
  1456. ──────────────────────────────────────────────────────
  1457. │  < or >   │          │          │                  │
  1458. │           │          │          │                  │
  1459. ──────────────────────────────────────────────────────
  1460. │  Enter    │          │   see    │                  │
  1461. │           │          │  note 1  │                  │
  1462. ──────────────────────────────────────────────────────
  1463. │  Space    │          │          │   plays sample   │
  1464. │           │          │          │ at last frequency│
  1465. ──────────────────────────────────────────────────────
  1466. │   Tab     │          │   see    │                  │
  1467. │           │          │  note 1  │                  │
  1468. ──────────────────────────────────────────────────────
  1469. │   Esc     │  stop    │  stop    │    exit from     │
  1470. │           │  song    │  voice   │ sample playback  │
  1471. ──────────────────────────────────────────────────────
  1472.  
  1473. Note 1:
  1474.  
  1475. During a VOC playback, <ENTER> key breaks a sample section,  and moves sample
  1476. offset to next marker immediately. <TAB> key works in a similar way, but wait
  1477. sample offset just after the current loop has finished.See your Creative Labs
  1478. manual for more information.
  1479.  
  1480. Note 2:
  1481.  
  1482. In Classic Mode, "Lock" keys (CapsLock, NumLock and ScrollLock)  allow Multi-
  1483. player to handle a different set of channels when numeric keys are pressed.
  1484. Normally,  key <1> turns channel #1 on (or off),  key <2> does the same thing
  1485. on channel #2, and so on. When <NumLock> key is on, it adds 10 to the channel
  1486. number used by a key, that is, channel 11 will be affected after <1> is pres-
  1487. sed and so on. <Scroll Lock> key adds 20 when it's turned on, and <Caps Lock>
  1488. adds 40 to the channel number. A combination of lock keys can be used for in-
  1489. termediate values. For examples, channel 34 can be affected by pressing 4 key
  1490. when both <NumLock> and <ScrollLock> have their light turned on.
  1491.  
  1492. Note 3:
  1493.  
  1494. During sample playback different from VOC files (RAW or WAV),  a piano keybo-
  1495. ard will be displayed on the main window.  You have a piano keyboard's octave
  1496. simulated on your PC keyboard:
  1497.  
  1498. ▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█
  1499. ▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█
  1500. ▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█▐█ ▐█ ▐█▐█ ▐█ ▐█ ▐█
  1501. ▐█▌██▌██▐█▌██▌██▌██▐█▌██▌██▐█▌██▌██▌██▐█▌██▌██▐█▌██▌██▌██▐█▌██▌██▐█▌██▌██▌██
  1502. ▐█▌██▌██▐█▌██▌██▌██▐█▌██▌██▐█▌██▌██▌██▐█▌██▌██▐█▌██▌██▌██▐█▌██▌██▐█▌██▌██▌██
  1503.  
  1504.                      2  E    5  6  7
  1505.                     Q  W  R T  Y  U  U I
  1506.  
  1507. All keys reported above allow Multiplayer to play a sample at different notes
  1508. by changing their playing frequency rate. The middle C frequency rate is 8800
  1509. Hz.
  1510.  
  1511. Note 4:
  1512.  
  1513. MultiPlayer plays also ROL files. No windows will be displayed.  Only ESC key
  1514. key will work, stopping the song.
  1515.  
  1516.  
  1517. 4.3. Mixer Control Panel
  1518.      -------------------
  1519.  
  1520. If you have a SoundBlaster Pro, or a 100% compatible card, you can get a full
  1521. control of its  internal mixer capabilities by  running a Mixer Control Panel
  1522. programmed into Multiplayer. Mixer is not available on a monophonic SoundBla-
  1523. ster (1.x or 2.x).  If no SoundBlaster is installed, your computer can crash.
  1524. If a SoundBlaster 16 (or ASP) is mounted on  your system, Mixer Control Panel
  1525. could have some trouble when it tries to set mixer registers.
  1526. You can run Mixer Control Panel on main desktop (by pressing F9, or selecting
  1527. corresponding menu option in the Devices menu), while a module or a sample is
  1528. playing (by pressing M key),  or in a DOS session,  by typing DGSMIXER at the
  1529. DOS prompt. You will see a window similar to figure #3. It can be different a
  1530. few, if it's executed on main destop or during a module playback, but working
  1531. is similar. Mouse can be used, but only if Mixer is executed in main desktop.
  1532. Mixer parameters you can modify are Master Volume (the common volume for each
  1533. channel), Voice (for modules or samples), FM (for all synthetized songs), Mi-
  1534. crophone and Line-In volumes (not used in Multiplayer, but you can be intere-
  1535. sted to change them if you're mixing a module with an external input device),
  1536. CD volume (for a CD-ROM connected to SoundBlaster directly - this is not used
  1537. in Multiplayer). A channel can be selected by moving left and right arrow key
  1538. (it will be highlighted by a white bar); its volume can be changed by presing
  1539. up or down arrow key. Coloured bars indicate the channel volume level. If you
  1540. have a mouse installed, you can click on the bars for changing volume. In the
  1541. main desktop's mixer, you can change left, right  or both channel volumes, it
  1542. depends by current mode. Mode is reported at the bottom, to the left of mixer
  1543. window. Normally, mode is set to middle, indicating that a volume change will
  1544. affect BOTH  channel volumes. This mode can be set by pressing M. Other modes
  1545. are LEFT (press the L key) and RIGHT (press the R key). In these cases,  only
  1546. one bar per channel will be increased or decreased (see figure #3). This fea-
  1547. ture is not available when mixer is used during a playback: in this case, the
  1548. only existing mode is MIDDLE.
  1549. The Mixer Control Panel used on the main desktop (not during a playback!) can
  1550. turn on (or off) in-out filters built into SoundBlaster Pro, by pressing F or
  1551. G. Also, S key can be pressed if you want to active Stereo internal register.
  1552. If you use a mouse, simply click on radio-buttons displayed at the mixer win-
  1553. dow's right.
  1554. During a Advanced Mode playback, you can press <F> or <G> keys to set filters
  1555. or <K> for stereo/mono playback (but not when mixer is shown).
  1556. You can close the Mixer by pressing <ESC> key, or by clicking left mouse but-
  1557. ton on the [OK] button.
  1558.  
  1559.  
  1560. -----------------------------------------------------------------------------
  1561.  
  1562.                      SoundBlaster Pro Mixer Control Panel
  1563.  
  1564.  
  1565.           Mast    Voic     FM      CD     Micr    Line        [■] filter in
  1566.   max _                                                       [ ] filter out
  1567.       _   █  █                                                [ ] stereo
  1568.       _   █  █            █                          █
  1569.       _   █  █    █  █    █  █                       █
  1570.       _   █  █    █  █    █  █                    █  █
  1571.       _   █  █    █  █    █  █                    █  █
  1572.   min _   █  █    █  █    █  █                    █  █
  1573.  
  1574.          14  14  10  10  12  10  00  00  01  01  08  12
  1575.  
  1576.  
  1577.    middle                                                      v2.5
  1578.  
  1579. -----------------------------------------------------------------------------
  1580.  
  1581.                         Figure #3 : Mixer Window
  1582.  
  1583.  
  1584. Multiplayer's Mixer Control Panel modifies internal sound card registers,  so
  1585. all channels will keep same volume also after Multiplayer is quitted. Another
  1586. application that doesn't modify mixer register by itself, will use these set-
  1587. tings.
  1588.  
  1589.  
  1590. 4.4. The VDS subsystem (release 1.063)
  1591.      ---------------------------------
  1592.  
  1593. VDS is for Virtual Dos Shell. It's a new Ms-Dos interface, created by dgs. It
  1594. will be installed in several dgs products, but actually it's installed in the
  1595. MultiPlayer desktop only. It allows you to  perform all typical operations on
  1596. data files in a window while Multiplayer continue to play a module. VDS works
  1597. similarly to the shell included into Telemate, a great shareware communicati-
  1598. ons program, maybe the best.
  1599. Like Telemate's Shell,  VDS is not a real Ms-Dos shell, so you cannot execute
  1600. external programs in it. Instead, you can execute most of basic Dos commands,
  1601. and something more. Syntax is very similar to the original Dos commands, but,
  1602. there may be some little difference.
  1603. Generally, all operations made by VDS don't affect sound quality. You can see
  1604. it, especially if you have a fast machine, and a good hard disk.
  1605. VDS can be used during module, CMF and VOC playback, but all desktop keys are
  1606. disabled. You cannot use VDS while you play a RAW/WAV sample or a ROL/MID mo-
  1607. dule song. If you're not playing modules (main desktop), you can run a 'real'
  1608. dos shell by selecting it from the FILE menu.
  1609.  
  1610. Here are the commands implemented in the VDS:
  1611.  
  1612. - COPY   : copy files from a drive or a directory to another. Syntax is simi-
  1613.            lar to Ms-Dos <COPY> command,  but when you specify  'C:' you mean
  1614.            to indicate the hard  disk's root directory. F or example,  if you
  1615.            type the following command:
  1616.  
  1617.                                COPY REDHOT.MOD A:
  1618.  
  1619.            VDS will copy REDHOT.MOD in the root directory of drive A. You can
  1620.            use also wildcards (*,?).  Don't try to copy from standard devices
  1621.            like CONsole device: effects can be unpredictable.
  1622.  
  1623. - MOVE   : copy files from a drive or a directory to another, then remove the
  1624.            original files.  Wildcards (*,?) are allowed  too. About directory
  1625.            specification, see the COPY command.
  1626.  
  1627. - REN    : rename a file. You must specify old name and new name.
  1628.  
  1629. - DIR    : if no parameter is specified after <dir>, it shows the current di-
  1630.            rectory; if parameter is a directory or a drive name,  it displays
  1631.            its contents.  You can also specify wildcards (*,?) as parameters.
  1632.            In this case, it displays a group of files only. This is a simpli-
  1633.            fied version of MS-DOS <dir> command.
  1634.  
  1635. - CD     : change current directory. If directory  doesn't exist, the command
  1636.            will have no effect.
  1637.  
  1638. - TYPE   : displays a text file. You can break this operation by pressing any
  1639.            key during file scrolling.
  1640.  
  1641. - CLS    : clear the virtual screen, that is, the text window used by VDS.
  1642.  
  1643. - VOLUME : this is not a DOS command. It changes master volume of module cur-
  1644.            rently played. You must specify an offset, not an absolute number,
  1645.            that is, a signed value to add to master volume.  If number is po-
  1646.            sitive, master volume will be increased;  otherwise it will be de-
  1647.            creased. This command doesn't work when you play CMF or VOC files.
  1648.  
  1649. - INSIDE : looks into a compressed archive,  and displays informations of fi-
  1650.            les included in it: file name, compressed file size, original file
  1651.            size, compression ratio (expressed in percent) and the compression
  1652.            method used.  INSIDE  recognizes ZIP, LHA,  LZH, SQZ, PAK, ARC and
  1653.            ARJ compressed files.
  1654.  
  1655.            For ZIP files,the compression type is identified by a digit in the
  1656.            range 0..9, according to the table reported below:
  1657.  
  1658.                                 0 : Stored
  1659.                                 1 : Shrunk  (all versions)
  1660.                                 2 : Reduce  (v0.92)
  1661.                                 6 : Implode (v1.00)
  1662.                                 8 : Deflate (v1.93)
  1663.  
  1664.            For PAK and ARC archives, method is identified by a number too:
  1665.  
  1666.                                 2 : Stored
  1667.                                 3 : Distilled
  1668.                                 4 : Squeezed
  1669.                                 8 : Crunched
  1670.                                 9 : Squash
  1671.                                10 : Crushed
  1672.                                11 : Distilled
  1673.  
  1674.            For LZH files, compression method is displayed with original level
  1675.            name (-lh1- to -lh5-), indicating the  compression rate  (that is,
  1676.            -lh5- method is the best, while -lh1- method is the worst)
  1677.  
  1678.            For ARJ archives, compression method is identified by a number:
  1679.  
  1680.                                 0 : Stored File
  1681.                                 1 : Good Compression
  1682.                                 2 : Normal Compression
  1683.                                 3 : Fast Compression
  1684.                                 4 : Fastest Compression
  1685.  
  1686.            For SQZ archives, a number in the range 0 to 4 identifies the com-
  1687.            pression rate.
  1688.  
  1689. - HELP   : show all commands recognized by VDS (without description!).
  1690.  
  1691. - EXIT   : exit from VDS. After VDS is turned off,  display will come back to
  1692.            Bar Mode.
  1693.  
  1694.  
  1695. ┌────────────────────────────────────────────────────────────────────────────┐
  1696. │                                                                            │
  1697. │                             5. ERROR MESSAGES                              │
  1698. │                                                                            │
  1699. └────────────────────────────────────────────────────────────────────────────┘
  1700.  
  1701.  
  1702. [115] Device not supported.
  1703.       Sound device selected by 'File' menu option is not supported by current
  1704.       playing mode, for example, when using a Covox in advanced mode, or when
  1705.       a sample is played. Check 'Sound Device' and 'Playing Mode' options.
  1706.  
  1707. [116] Too many channels.
  1708.       There was an attempt to play a WAV sample having more than one channel.
  1709.       Multiplayer supports one-channel WAV samples only.
  1710.  
  1711. [117] Can't play 16-bit samples.
  1712.       Self-explaining. It could happen when a WAV sample is played. Multipla-
  1713.       yer supports 8-bit samples only.
  1714.  
  1715. [118] Out of memory.
  1716.       A sample, or an image cannot fit in expanded memory. A module cannot be
  1717.       allocated in conventional memory. A file is corrupted.
  1718.  
  1719. [119] External file not found.
  1720.       One of the  overlays cannot  be found in  the Multiplayer's  directory.
  1721.       Check if you have a complete Multiplayer installation.
  1722.  
  1723. [120] External program failure.
  1724.       One of the overlays generated an error. It can occour when:
  1725.       a) you want to play a synth music file, and corresponding TSR driver is
  1726.          not installed in memory.
  1727.       b) an unrecoverable error is occurred (disk or memory access).
  1728.       c) overlay file is not correct, or it's missing.
  1729.       d) a music file is damaged.
  1730.  
  1731. [121] Error on LZMOD database.
  1732.       LZMODARC file was not found in a directory where PATH statement points,
  1733.       or it's damaged.
  1734.  
  1735. [122] Error in loading image.
  1736.       An image file is corrupted, or is not one of the formats recognized.
  1737.  
  1738. [123] VGA card not installed.
  1739.       An image cannot be displayed. Only VGA can be used for displaying it.
  1740.  
  1741. [124] Invalid module type.
  1742.       A module is not recognized, or it's corrupted. Try to use another modu-
  1743.       le player.
  1744.  
  1745. [125] File Open Error (or [File Error]).
  1746.       A module cannot be played. It can occur when:
  1747.       a) it's not a format recognized.
  1748.       b) it's corrupted.
  1749.       c) it has the read-only attributed turned on.
  1750.       d) it's not found after it was extracted. In this case, check if tempo-
  1751.          rary directory exists, or if your hard disk is full.
  1752.       e) you are using Multiplayer on a network, and module is currently loa-
  1753.          ded by another user.
  1754.  
  1755. [127] SoundBlaster Driver Error.
  1756.       A CMF music file was trying to be played, and SBFMDRV.COM driver wasn't
  1757.       installed in memory.
  1758.  
  1759. [128] Module file corrupted.
  1760.       Some trouble occurred when a module was loaded (some pattern or samples
  1761.       miss in the module file).
  1762.  
  1763. [130] Module not loaded.
  1764.       Some trouble occurred when a module was loaded (file disappeared)
  1765.  
  1766. [132] Module file too short.
  1767.       Some pattern or sample cannot  be loaded  properly. It shouldn't occur,
  1768.       since Multiplayer tries to load the module anyway.
  1769.  
  1770. [135] File damaged.
  1771.       A generic file (module, image or sample) is damaged.
  1772.  
  1773. [136] File format not supported.
  1774.       A module type is recognized, but it's not supported yet. For example it
  1775.       occour if  you try to  load a JMPlayer module (JMS),  or a UltraTracker
  1776.       module having 16-bit samples.
  1777.  
  1778.  
  1779. ┌────────────────────────────────────────────────────────────────────────────┐
  1780. │                                                                            │
  1781. │                     6. MULTIPLAYER SCRIPT LANGUAGE                         │
  1782. │                                                                            │
  1783. └────────────────────────────────────────────────────────────────────────────┘
  1784.  
  1785.  
  1786. Multiplayer can execute script files  written in a language, the MPS.  It's a
  1787. language oriented  to graphic presentations, like Multimedia Player  (MMPLAY)
  1788. provided with SoundBlaster cards.  Unlike MMPLAY, it can shows images (GIF or
  1789. PCX), Autodesk Animator FLICs (FLI), use more sound devices, write text, work
  1790. on multiple screen modes  (all modes supported by VGA BIOS).  All this can be
  1791. combined with module file playback, stored in one of the formats supported by
  1792. Classic Mode.
  1793. All script files must have .MPS extension, if they should be executed by Mul-
  1794. tiplayer directly. If MPSPLAY is  used, any file, extension can be used,  but
  1795. MPS is the default extension when no extension is specified.
  1796. In this version, MPS language has 36 instructions. A parameter may be present
  1797. after the command; it can be surrounded by double-quotes.You can use any text
  1798. editor to create scripts. Commands are case insensitive, and can be preceeded
  1799. by spaces, NOT tabs. Any text line cannot be longer than 75 characters.
  1800.  
  1801.  
  1802. 6.1. Command Description, and Examples
  1803.      ---------------------------------
  1804.  
  1805. ! <text>
  1806. # <text>
  1807. ; <text>
  1808.  
  1809. one of these symbols is used for putting a comment  in a script file. A space
  1810. must be present between symbol and text.
  1811.  
  1812. LOADMOD <module>
  1813.  
  1814. loads a module in memory, without playing it. File extension is mandatory.
  1815.  
  1816.                         LoadMOD "debmix1.6cm"
  1817.                         PlayMOD
  1818.  
  1819. SHOWPIC <filename>
  1820.  
  1821. loads and displays a picture file (GIF or PCX), then, waits for a command key
  1822. to continue. An arrow key moves the picture through the screen. Press ESC key
  1823. to continue with script execution. Screen must be set to 320x200, 256 colors.
  1824.  
  1825.                         Screen 19
  1826.                         ShowPIC wendy.gif
  1827.  
  1828. KEY <ASCII value>
  1829. PAUSE <ASCII value>
  1830.  
  1831.                         Text "Press <C> key to continue"
  1832.                         Key 99
  1833.  
  1834. wait until a key is pressed. If <ASCIIvalue> is specified, script can be con-
  1835. tinued only if that key is pressed. If no value is specified,  any key can be
  1836. pressed.
  1837.  
  1838. TEXT <string>
  1839.  
  1840. displays a string specified in the current cursor position.
  1841.  
  1842.                         Text "This is a text string"
  1843.  
  1844. SCREEN <mode>
  1845.  
  1846. change screen mode,  according to standard VGA bios modes,  explained in  any
  1847. VGA manual. Here follows more frequently used VGA modes:
  1848.  
  1849.               Screen 0        - Text Mode, 40x25
  1850.               Screen 3        - Text Mode, 80x25
  1851.               Screen 19       - Graphic Mode, 320x200, 256 colors
  1852.  
  1853. PLAYFLIC <animation>
  1854.  
  1855. loads a Autodesk Animator sequence (FLI), and show a indefinite number of ti-
  1856. mes, until a key is pressed. Screen must be set to 320x200, 256 colors.
  1857.  
  1858.                         Screen 19
  1859.                         PlayFLIC "3dstudio.fli"
  1860.  
  1861. XPOS <value>
  1862.  
  1863. sets current x position for next TEXT command.
  1864.  
  1865.                         XPos 10
  1866.                         YPos 12
  1867.                         Text "This is a string"
  1868.  
  1869. YPOS <value>
  1870.  
  1871. sets current y position for next TEXT command.
  1872.  
  1873. HOME
  1874.  
  1875. sets current position to (1,1).
  1876.  
  1877. SHOWIMG <file name>
  1878.  
  1879. loads a picture (GIF or PCX). Screen must be set to 320x200, 256 colors. Only
  1880. first part of a picture will be displayed on screen.
  1881.  
  1882.                         Screen 19
  1883.                         Home
  1884.                         ShowIMG "lisa.gif"
  1885.                         Text "Press <Enter>"
  1886.                         Key 13
  1887.                         ShowIMG "lorella.pcx"
  1888.  
  1889. CLS
  1890.  
  1891. clear screen, and puts currents position to <home> position (1,1). Color will
  1892. be set to colors previously decided by <BColor> and <FColor> commands.
  1893.  
  1894.                         BColor 1
  1895.                         FColor 14
  1896.                         Cls
  1897.                         Text "Yellow on Blue"
  1898.  
  1899. FCOLOR <color number>
  1900.  
  1901. sets current foreground color. A number from 0 to 255 can follow the command.
  1902.  
  1903.                         FColor 14
  1904.                         Text "Yellow"
  1905.  
  1906. BCOLOR <color number>
  1907.  
  1908. sets background color, in text mode. A number from 0 to 7 can be utilized.
  1909.  
  1910.                         FColor 11
  1911.                         BColor 4
  1912.                         Text "Cyan on Red"
  1913.  
  1914. STOP
  1915.  
  1916. stops script execution immediately. It should be last instruction in a script
  1917. file.
  1918.  
  1919. SLEEP <value>
  1920.  
  1921. delays script execution for <value> seconds.
  1922.  
  1923.                         ShowIMG "debbie.pcx"
  1924.                         Sleep 3
  1925.                         ShowFLI "car.fli"
  1926.  
  1927. PLAYMOD
  1928.  
  1929. plays the module currently loaded and continues script execution.
  1930.  
  1931.                         LoadMOD "canguro.mod"
  1932.                         PlayMOD
  1933.                         Text "Press a key to stop module"
  1934.                         Key
  1935.                         StopMOD
  1936.  
  1937. STOPMOD
  1938.  
  1939. stops current module.
  1940.  
  1941. LOADPLAYMOD <module>
  1942.  
  1943. loads a module and starts playback,  then continue script  execution. It is a
  1944. short way to perform LoadMOD and PlayMOD commands.
  1945.  
  1946.                         LoadPlayMOD "u2.mod"
  1947.                         Key 13
  1948.                         StopMOD
  1949.  
  1950. JUMP <line>
  1951.  
  1952. jumps in script file backwards (or forward) to the line number specified. <1>
  1953. is the first script line. A line number can be deduced by a text editor.
  1954.  
  1955.                         Text "Jump Demonstration"
  1956.                         Text "Press <Enter>"
  1957.                         Key 13
  1958.                         LoadCSample "ding.raw"
  1959.                         PlayFLIC1 "girl.fli"
  1960.                         Text "Press a key to repeat"
  1961.                         Key
  1962.                         Jump 4
  1963.  
  1964. (note: to exit from this example, press <Ctrl-Break>, when you will be asked
  1965. for a key)
  1966.  
  1967. PLAYFLIC1 <animation>
  1968.  
  1969. loads and displays a Autodesk Animation sequence only one time.
  1970.  
  1971.                         PlayFLIC1 "demo.fli"
  1972.  
  1973. LOADCSAMPLE <name>
  1974.  
  1975. loads and plays a raw sample.  Before playing it, a signum conversion is per-
  1976. formed. Playback frequency must be set by <Frequency> command, else a default
  1977. frequency will be set to 11000Hz.
  1978.  
  1979.                         SoundDevice 5
  1980.                         Frequency 22000
  1981.                         LoadCSample "ding.raw"
  1982.  
  1983. LOADSAMPLE <name>
  1984.  
  1985. loads and plays a raw sample, at frequency decided by <Frequency> command, or
  1986. 11000Hz by default.
  1987.  
  1988. FREQUENCY <value>
  1989.  
  1990. sets frequency value for sample playback.
  1991.  
  1992. VOLUME <value>
  1993.  
  1994. sets current master volume, for module or sample playback.
  1995.  
  1996.                         LoadMOD "goldrake.6cm"
  1997.                         Volume 50
  1998.                         PlayMOD
  1999.  
  2000. SOUNDDEVICE <device number>
  2001.  
  2002. sets current sound card used. A number from 1 to 9 should be specified.
  2003.  
  2004.                   1       : PC Speaker
  2005.                   2       : Adlib
  2006.                   3       : Covox Mono
  2007.                   4       : Covox Stereo
  2008.                   5, or 9 : SoundBlaster
  2009.                   6       : SoundBlaster Pro, or SoundBlaster 16
  2010.                   7       : Pro Audio Spectrum
  2011.  
  2012. warning: devices  from 1 to 4 shouldn't be used  if some FLI sequence must be
  2013.          displayed, since they don't use DMA for playback.
  2014.  
  2015.                         ; Now I select the Covox Mono Device
  2016.                         SoundDevice 4
  2017.                         LoadSample "glass.raw"
  2018.  
  2019. MIXRATE <value>
  2020.  
  2021. sets frequency mix rate to <value>. Default value is 16000.
  2022.  
  2023.                         SoundDevice 6
  2024.                         MixRate 22000
  2025.                         LoadPlayMOD LIYE.MOD
  2026.                         Sleep 60
  2027.                         StopMOD
  2028.  
  2029. REPEAT <times>
  2030.   command
  2031.   command
  2032.   ..
  2033.   ..
  2034. END
  2035.  
  2036. repeats a sequence of commands,  included by  <Repeat> and  <End> commands, a
  2037. number of times specified by Repeat parameter. For example:
  2038.  
  2039.                         Repeat 3
  2040.                           PlaySample "foo.raw"
  2041.                           PlayFLIC1 "foo2.fli"
  2042.                           Xpos 1
  2043.                           Ypos 25
  2044.                           Text "Press <Enter>"
  2045.                           Key 13
  2046.                         End
  2047.  
  2048. (this example is easy to understand, I hope...)
  2049.  
  2050. NEWLINE
  2051.  
  2052. move the text cursor position to the following screen row, in the column 1.
  2053.  
  2054.                         Cls
  2055.                         Text "Screen Row 1"
  2056.                         NewLine
  2057.                         Text "Screen Row 2"
  2058.  
  2059. FADEIN
  2060.  
  2061. fades the current screen in. The <ResetPalette> command must be called before
  2062. fade-in. For example:
  2063.  
  2064.                         ResetPalette
  2065.                         Text "ready for fade-in"
  2066.                         Text "press a key"
  2067.                         Key
  2068.                         FadeIn
  2069.  
  2070. (note: strings after <Text> commands will be displayed only after FadeIn com-
  2071. mand)
  2072.  
  2073. FADEOUT
  2074.  
  2075. fades the current screen out, by resetting all screen palettes.
  2076.  
  2077.                         Screen 19
  2078.                         LoadIMG "mike.pcx"
  2079.                         Sleep 2
  2080.                         FadeOut
  2081.                         Screen 3
  2082.  
  2083. RESETPALETTE
  2084.  
  2085. blanks current palette, for fade-in purposes (see Fade-In command).
  2086.  
  2087.  
  2088. ┌────────────────────────────────────────────────────────────────────────────┐
  2089. │                                                                            │
  2090. │                               7. UTILITIES                                 │
  2091. │                                                                            │
  2092. └────────────────────────────────────────────────────────────────────────────┘
  2093.  
  2094.  
  2095. MultiPlayer package includes several external command-line programs:
  2096.  
  2097.  
  2098. [DGSMIXER.EXE] - SoundBlaster Pro Mixer.
  2099.  
  2100. This utility runs  Multiplayer's internal Mixer Control Panel,  directly from
  2101. DOS command line. All Multiplayer overlay files must be installed.
  2102.  
  2103.  
  2104. [MOD2FAR.EXE] - A module converter.
  2105.  
  2106. It converts the most common MODs (Sound/Noise/ProTracker,  ModEdit, StarTrek-
  2107. ker and Triton FastTracker) to Farandole Composer format. Both source and de-
  2108. stination file names must be specified. You can specify a transpose parameter
  2109. too, a integer number  (positive or negative)  indicating how  much semitones
  2110. must be added or subtracted to notes utilized in module patterns. This option
  2111. is included in MOD2FAR because some module tracker plays FAR files by using a
  2112. different tone offset.
  2113.  
  2114.  
  2115. [STEREO.EXE] - Turns the stereo register on/off.
  2116.  
  2117. This small utility sets the SoundBlaster Pro Stereo register in order to play
  2118. music files in Mono or Stereo. If you specify a value of 0 on the command li-
  2119. ne, SoundBlaster Pro register will be set to Mono,  so all music applications
  2120. play music files in Mono (unless they set the Stereo register by theirselves,
  2121. like DMP does). If a value of '1' is specified on the command line, SoundBla-
  2122. ster is put in Stereo Mode:in this case MultiPlayer will play all music files
  2123. in stereo. This is the default value chosen when no parameter is specified on
  2124. the command line.
  2125. STEREO.EXE looks for the BLASTER variable in the DOS environment table to de-
  2126. termine SoundBlaster's I/O address.
  2127.  
  2128. Note: This program works on SoundBlaster Pro release 1.0 only, since Standard
  2129.       and 16-bit SoundBlasters hasn't the Stereo register.
  2130.  
  2131.  
  2132. [AMFPLAY.EXE] - AMF module player.
  2133.  
  2134. This program allows to play the Otto Chrons' AMF modules, up to release 1.11,
  2135. directly from the command line.
  2136. It requires a PC with a 80386 or a 80486 processor, 640k RAM, a SoundBlaster,
  2137. a Pro Audio Spectrum or an Aria sound card.  No configuration file is needed,
  2138. since your sound card will be automatically detected.
  2139. The AMFPLAY syntax is the following:
  2140.  
  2141.                     AMFPLAY <module file name> <options>
  2142.  
  2143. Options can be:
  2144.  
  2145. -b : set the buffer size to a value specified.
  2146. -f : change frequency rate.
  2147. -l : play module in loop mode.
  2148. -s : don't load unused samples and patterns (save memory for bigger mods).
  2149.  
  2150. Buffer size must be less than 8192 bytes, and the frequency mix rate up to 22
  2151. KHz, resulting in a very good sound output  (AMFPLAY uses same routines  used
  2152. in Multiplayer's Advanced Mode).
  2153. You can stop module playing and return to DOS by pressing ESC.
  2154.  
  2155.  
  2156. [AMFVER.EXE] - AMF module utility.
  2157.  
  2158. This utility returns the version number for an AMF module.
  2159.  
  2160.  
  2161. [MPLAY.EXE] - Multiplayer Command/Line Player.
  2162.  
  2163. This is a little player allowing you to  play all module formats available in
  2164. Multiplayer's Classic Mode. You must specify module file name only.
  2165. The  playing information (Frequency Rate, Device, and so on) is loaded direc-
  2166. tly from MULTIP.CFG file.  You can stop module and return to DOS by  pressing
  2167. the <ESC> key. Unlike MultiPlayer, MPLAY can be executed on a PC with a 80286
  2168. processor too.
  2169.  
  2170.  
  2171. [RAWPLAY.EXE] - Raw Sample Player.
  2172.  
  2173. This utility plays 8-bit samples, including all raw samples created by Multi-
  2174. player's  <Raw Sample File> output device.  Also, you can play VOC/WAV files,
  2175. but you should use <-o> option in order to skip its header.
  2176. RAWPLAY requires a 80386 or a 80486 processor, any SoundBlaster, PAS  or Aria
  2177. sound card. Sample can be loaded into base memory (by default) or into expan-
  2178. ded/extended memory.  The sample will  be loaded entirely in memory,  so, you
  2179. need enough memory to load it.
  2180. The RAWPLAY syntax is the following:
  2181.  
  2182.                       RAWPLAY <sample file> <options>
  2183.  
  2184. Options can be:
  2185.  
  2186. -f : specify the sampling rate.
  2187. -c : convert the signum (from unsigned to signed, or viceversa). Original si-
  2188.      gnum cannot be detected. If a sample squeaks during playback, try to use
  2189.      this option.
  2190. -l : loop the sample, until you press a key.
  2191. -e : use expanded memory. It must be used when a sample cannot fit in the ba-
  2192.      se memory. Be sure you've any memory manager (QEMM, EMM386, MEMMAKER  or
  2193.      similar) installed.
  2194. -x : use extended memory. It must be used when a sample cannot fit in the ba-
  2195.      se memory. You must have HIMEM.SYS (or an equivalent driver) installed.
  2196. -o : starts the sample playback at a specific offset, that is, the first byte
  2197.      in the sample file. You can use this option to play correctly files with
  2198.      a header (for example, VOCs or WAVs).
  2199. -v : set the master volume.
  2200. -r : specify the frequency mix rate. If the sample was created by Multiplayer
  2201.      you should specify the same sampling rate used during the original modu-
  2202.      le playback.
  2203. -b : specify a buffer size for samples. Default value is 2048 bytes. A higher
  2204.      value is required when RAWPLAY is executed under Microsoft Windows.
  2205.  
  2206. A sample is played in mono, on both amplifier channels, even if you have some
  2207. stereo board. You can stop sample playback by pressing any key.  RAWPLAY  was
  2208. written by using DSMI release 1.0, the Otto Chrons Digital Sound Music Inter-
  2209. face programming toolkit.
  2210.  
  2211.  
  2212. [WHICH.EXE] - Gives some information on a sound card installed.
  2213.  
  2214. This utility displays all main informations on your sound card. It's included
  2215. in Multiplayer package,  since it informs you  about  the minimum and maximum
  2216. frequency rate supported by sound card (needed for configuring Multiplayer in
  2217. the best way).  A <No Sound Card> message will be shown if your sound card is
  2218. not recognized or not installed properly.
  2219.  
  2220.  
  2221. [MPLANG.EXE] - Installs a Multiplayer's language file.
  2222.  
  2223. MPLANG shows a little menu, on  the basis of language text files installed in
  2224. the  Multiplayer's directory.  Available languages  will depend from  current
  2225. Multiplayer version.  A numeric key is used to choose  a particular language.
  2226. Press <0> or <Ctrl-C> to  return to DOS without changing configuration.
  2227.  
  2228.  
  2229. [MPPATCH.EXE] - Shows current Multiplayer's patch level.
  2230.  
  2231. You can launch this program  directly from  DOS  command line.  Press <Enter>
  2232. after the  message box is displayed.  If no message is returned,  you have an
  2233. unpatched version for Multiplayer.
  2234.  
  2235.  
  2236. [PICGRAB.EXE] - A picture grabber.
  2237.  
  2238. It's a TSR program. You can install it in upper or lower memory, requiring a-
  2239. bout 44k. It can be actived when screen is in graphic mode. Simply press Ctrl
  2240. Alt and G keys. A rectangle will appear over your image. Press <Space> to re-
  2241. size the rectangle, so it can grab a complete screen. Then,  press left mouse
  2242. button. A .PIC image will be created, together with .PAL palette file. PIC is
  2243. compatible with images utilized in Classic/Graph mode.
  2244.  
  2245.  
  2246. [MPSPLAY.EXE] - a script player.
  2247.  
  2248. This program executes MPS scripts. A file name must be specified.  It's fully
  2249. compatible with MPS language described in section 6.1.
  2250.  
  2251.  
  2252. ┌────────────────────────────────────────────────────────────────────────────┐
  2253. │                                                                            │
  2254. │                               8. WHAT TO DO?                               │
  2255. │                                                                            │
  2256. └────────────────────────────────────────────────────────────────────────────┘
  2257.  
  2258.  
  2259. I don't know  if Multiplayer will be released again in the future. Anyway, if
  2260. it will happen, it will have (I hope...):
  2261.  
  2262. a) a Karaoke system (editing+playback).
  2263. b) new music and graphics formats.
  2264. c) a lot of things....
  2265.  
  2266.  
  2267. ┌────────────────────────────────────────────────────────────────────────────┐
  2268. │                                                                            │
  2269. │                             9. INTERNET SUPPORT                            │
  2270. │                                                                            │
  2271. └────────────────────────────────────────────────────────────────────────────┘
  2272.  
  2273.  
  2274. MultiPlayer is available via Internet on Anonymous FTP Sites , or via several
  2275. Bulletin Board Systems.
  2276.  
  2277. The compressed file is called MULTPxxx.ZIP, where <xxx> is the actual version
  2278. number (for example, MULTP122.ZIP is the file containing release 1.22).
  2279. Multiplayer is available through some patch file too. A patch is a bugfix pa-
  2280. ckage: it cannot be installed without having a specific program version. Mul-
  2281. tiplayer 3.0 has several patch levels.  These files are  called  MP3PLxxx.ZIP
  2282. and can be found on FTP, together with complete package.
  2283.  
  2284. Multiplayer has now an official anonymous  FTP site, where Multiplayer's last
  2285. release is stored. Just type:
  2286.  
  2287.                       ftp -v csdux01.cised.unina.it
  2288.  
  2289. and login as 'anonymous' or 'ftp'.  Then, insert your e-mail address as pass-
  2290. word and change to the /pub/msdos/sound directory.
  2291.  
  2292. Here follow other FTP sites where you can find some Multiplayer release:
  2293.  
  2294. garbo.uwasa.fi                 /pc/sound                           [2.11]
  2295. nic.funet.fi                   /pub/msdos/sound/sound              [2.05]
  2296. sun.rz.tu-clausthal.de         /pub/msdos/sound                    [2.01]
  2297. cs.uwp.edu                     /pub/msdos/modplayers               [3.00]
  2298. sound.usach.cl                 /pub/Sound/Players/PC               [1.50]
  2299. wuarchive.wustl.edu            /pub/MSDOS_UPLOADS/modplayers       [3.05]
  2300.  
  2301. The Multiplayer Mailing List (M.M.L.) is now available  for all Multiplayer's
  2302. users. Simply contact me by writing to the following e-mail address:
  2303.  
  2304. <progetto@csdux01.cised.unina.it>
  2305.  
  2306. and specify the subject 'Multiplayer Mailing List' in the mail header. Throu-
  2307. gh this mailing list, you can  have informations, give your comments, bug re-
  2308. ports and so on. Also, you can be contacted in order to collaborate on impro-
  2309. ving Multiplayer by yourself.
  2310.  
  2311. If you have not access to Internet, you can give your own comments, by using
  2312. the postal mail by writing to:
  2313.  
  2314. DGSoftware / Music
  2315. c/o Davide Guida
  2316. via Rodolfo Falvo 10
  2317. 80127 Napoli (Italia)
  2318.  
  2319. Note: also if you will be a M.M.L. member, you cannot ask me for source code,
  2320.       particularly the sound routines. The VangelisTeam sound library is ava-
  2321.       ilable by writing to VangelisTracker's authors directly or via Internet
  2322.       in the  file vt12src.zip  (located in the most popular FTP sites).  The
  2323.       Otto Chrons' DSMI (Digital Sound and Music Interface) package is a com-
  2324.       mercial product, so, you should buy a copy of it if you want to use it.
  2325.       See DMP program documentations, for further informations about this de-
  2326.       velopment kit.
  2327.  
  2328.  
  2329. ┌────────────────────────────────────────────────────────────────────────────┐
  2330. │                                                                            │
  2331. │              10. ELECTRICAL SCHEMES FOR COVOX COMPATIBLE DACS              │
  2332. │                                                                            │
  2333. └────────────────────────────────────────────────────────────────────────────┘
  2334.  
  2335.  
  2336. COVOX LPT1 CARD
  2337. RESISTOR ELECTRICAL SCHEME
  2338.  
  2339.  
  2340.           Printer Port:
  2341.  
  2342.           signal   pin        20k   20k
  2343.           D0       2      >───░░░─┬─░░░──0v
  2344.                               20k ░ 10k
  2345.           D1       3      >───░░░─┤
  2346.                               20k ░ 10k
  2347.           D2       4      >───░░░─┤
  2348.                               20k ░ 10k
  2349.           D3       5      >───░░░─┤
  2350.                               20k ░ 10k
  2351.           D4       6      >───░░░─┤
  2352.                               20k ░ 10k
  2353.           D5       7      >───░░░─┤
  2354.                               20k ░ 10k
  2355.           D6       8      >───░░░─┤
  2356.                               20k ░ 10k
  2357.           D7       9      >───░░░─┤
  2358.                                   ░ 10k  100nF
  2359.                                   ├──────┤█────> TO AMPLIFIER
  2360.                                   ░ 10k
  2361.           GND      20     >───────┼────────────>
  2362.                                   0v
  2363.  
  2364.  
  2365. COVOX LPT1 CARD
  2366. FERRANTI ELECTRICAL SCHEME
  2367.  
  2368.  
  2369.                                Zn426e    +5V
  2370.     D-type pin no  \          ┌────────┐  │
  2371.                   (2)  D0  ───┤9     14├──┤
  2372.                   (3)  D1  ───┤10      │ ┌┴┐
  2373.                   (4)  D2  ───┤11      │ │ │ 390Ω
  2374.                   (5)  D3  ───┤12      │ └┬┘
  2375.                   (6)  D4  ───┤13     5├──┤
  2376.                   (7)  D5  ───┤1      6├──┤       +
  2377.                   (8)  D6  ───┤2      4├──│────────┤█────> TO AMPLIFIER
  2378.                   (9)  D7  ───┤3   7   │  │        10µF
  2379.                               └────┬───┘ +╧        (may not be needed)
  2380.                                    │ 4.7µF█
  2381.                                    │      │
  2382.                   (25) GND ────────┴──────┴────────────── GND
  2383.  
  2384.  
  2385. COVOX LPT1 CARD
  2386. DAC080 ELECTRICAL SCHEME
  2387.  
  2388.  
  2389.                                DAC 080x
  2390.    Parallel Port Pin          ┌────────┐0.01µF  0.1µF
  2391.                   (2)  D0  ───┤12    16├──┤█────┤█──────┬─── GND
  2392.                   (3)  D1  ───┤11      │                │
  2393.                   (4)  D2  ───┤10    15├─────────██████─┘5kΩ
  2394.                   (5)  D3  ───┤9       │
  2395.                   (6)  D4  ───┤8     14├─────────██████─┐5kΩ
  2396.                   (7)  D5  ───┤7     13├────────────────┤
  2397.                   (8)  D6  ───┤6      2├──┤█────────────┴── +5V
  2398.                   (9)  D7  ───┤5 3 1  4├──────────┤█────> TO AMPLIFIER
  2399.                               └──┬─┬───┘0.1µF    + 10µF
  2400.                                  └─┤             (may not be needed)
  2401.                                    │
  2402.                   (25) GND ────────┴──────────────────── GND
  2403.  
  2404.                                   Note : capacitors are ceramic!
  2405.  
  2406.  
  2407. These electrical schemes was taken from ModPlay's documentation. ModPlay is a
  2408. module player created by Mark J. Cox.
  2409.  
  2410.  
  2411.  
  2412.  
  2413. ==============================================================================
  2414.  
  2415.                           MultiPlayer History File
  2416.  
  2417. -----------------------------------------------------------------------------
  2418.  
  2419. Release 3.25                                              (April 10th, 1994)
  2420.  
  2421. - Bugs fixed.
  2422. + Added 8-bit UltraTracker (ULT), Liquid Tracker (LIQ) and Farandole Compo-
  2423.   ser (FAR) module formats.
  2424. + A new MIDI player can be used in place of PLAYMIDI, for use with GUS card
  2425.   or standard SoundBlasters.
  2426. + Added the MultiPlayer Script Language (MPS), for creating superb multime-
  2427.   dia presentations.
  2428. + Graph Playing Mode has changed look. See MANUAL.DOC for informations.
  2429. + Improved sound with all devices used in Classic Mode.
  2430. + DMP-32 Playing Mode added! - for using Multiplayer as a front-end for new
  2431.   <Protected Mode> Dual Module Player.
  2432. + Added PICGRAB.EXE - utility for creating PIC images.
  2433. + 'LZMOD Filter' option added - for selecting a part of a LZMOD archive.
  2434.  
  2435. -----------------------------------------------------------------------------
  2436.  
  2437. Release 3.05                                              (March 19th, 1994)
  2438.  
  2439. - Bugs fixed and minor corrections made.
  2440. + /noxm option added for no extended memory checking.
  2441. + Mouse support improved.
  2442. + Added MPMODDIR environment variable.
  2443. + AMFVER.EXE utility added.
  2444. + DGSMIXER.EXE utility added.
  2445.  
  2446. -----------------------------------------------------------------------------
  2447.  
  2448. Release 3.04                                              (March 16th, 1994)
  2449.  
  2450. - Bugs fixed and minor corrections made.
  2451. + Added Spanish message file.
  2452. + Added ColorRix VGA Paint (SCI) graphic format.
  2453.  
  2454. -----------------------------------------------------------------------------
  2455.  
  2456. Release 3.03                                               (March 2nd, 1994)
  2457.  
  2458. - Bugs fixed.
  2459. - Now Multiplayer needs less memory to run: about 1Mb free expanded memory.
  2460. + Multiplayer loads read-only files correctly now.
  2461. + Added HS2 graphic format support.
  2462.  
  2463. -----------------------------------------------------------------------------
  2464.  
  2465. PatchPack v1.01 - February 26th, 1994
  2466.  
  2467. - Version required : Multiplayer v3.00
  2468.                      Multiplayer PatchPack v1.00
  2469. - Files added      : MPPMESG.FRE
  2470.                      MPLANG.EXE
  2471. - Files modified   : MPPADV.OVL
  2472.                      MPP300.OVL
  2473.                      MULTIP.EXE
  2474.                      RAWPLAY.EXE
  2475. - Additions        : <K> command in Advanced Mode, in order to switch from
  2476.                      mono to stereo sound output (or viceversa).
  2477.                      Overlay file containing messages in French.
  2478.                      MPLANG program, in order to simplify the language in-
  2479.                      stallation.
  2480.                      A screen saver: just  press the left mouse  button on
  2481.                      the white box located at the top, to the right of the
  2482.                      screen).
  2483. - Modifications    : Changed and improved all file requesters.
  2484. - Enhancements     : Improved mouse support in the file requesters.
  2485.                      Enhanced RAWPLAY.EXE utility.  See internal help, for
  2486.                      options).
  2487.  
  2488. -----------------------------------------------------------------------------
  2489.  
  2490. PatchPack v1.00 - February 2nd, 1994
  2491.  
  2492. - Version required : Multiplayer v3.00
  2493. - Files added      : MPPATCH.EXE
  2494. - Files modified   : MPP300.OVL
  2495.                      MULTIP.EXE
  2496. - Additions        : XMS support.
  2497. - Modifications    : Fixed CPU Identification (it failed on 486s).
  2498. - Enhancements     : None.
  2499.  
  2500. -----------------------------------------------------------------------------
  2501.  
  2502. Release 3.00                                            (January 23th, 1994)
  2503.  
  2504. - Several bugs fixed, routines corrected, source code optimized and so on...
  2505. - S3MRIP utility not included from this release, since it's obsolete (it do-
  2506.   esn't work good with new Future Crew's demos).
  2507. + Added a 'multimedial' intro for graphic lovers!
  2508. + Added a System Information option in the file menu.
  2509. + ARJ/SQZ compressed archives can be used for (un)packing modules.
  2510. + Now you can display PIC/PCX/GIF/FLI graphic files, and TXT/DOC text files.
  2511. + Added Classic/Graph mode, for displaying a real-time graph during a module
  2512.   playback.
  2513. + Enhanced SoundBlaster Pro Mixer Control Panel.
  2514. + The internal sample player and RAWPLAY.EXE can play samples long up to ex-
  2515.   panded memory size.
  2516.  
  2517. -----------------------------------------------------------------------------
  2518.  
  2519. Release 2.12b                                          (December 11th, 1993)
  2520.  
  2521. - Bugs fixed and colors adjusted.
  2522. + Adjusted some MED command implementation.
  2523. + Added a 'confirmation box' when exiting to DOS.
  2524.  
  2525. -----------------------------------------------------------------------------
  2526.  
  2527. Release 2.11                                            (December 9th, 1993)
  2528.  
  2529. + MTM (MultiTracker) format added (in Classic Mode).
  2530. + You can view VGA Dump Images (DMP)  created by VGAGRAB screen dumper by W.
  2531.   van Leijer.
  2532. + Channels option added. See documentation for more informations.
  2533. + Up to 32 channels can be played now.
  2534. + New coloured desktop with nice colors and windows.
  2535.  
  2536. -----------------------------------------------------------------------------
  2537.  
  2538. Release 2.10                                           (November 28th, 1993)
  2539.  
  2540. - MsDos 6.2 makes MultiPlayer 2.05 out of order....! PC crashes every time a
  2541.   key is pressed while a module is played. All bugs are now removed, I hope!
  2542. - Bug fixed : when you are in Automatic Mode, SoundBlaster Pro Mixer was di-
  2543.   sabled when a MED, P16 or OKT module was played.
  2544. + Added WAV/RAW internal player.
  2545. + Mouse (with graphical cursor) support added!
  2546.  
  2547. -----------------------------------------------------------------------------
  2548.  
  2549. Release 2.05                                           (November 18th, 1993)
  2550.  
  2551. - Bugs removed in some Advanced Mode function.
  2552. + Frequency rate can be increased up to 65000 (in setup menu) : you can know
  2553.   what is the maximum allowed by your card by using the WHICH utility.
  2554. + Improved CMF-VOC playing screens.
  2555. + MIDI support for SoundBlaster Pro, ASP or WAVEBlaster Cards (thru a SBMIDI
  2556.   driver installed and the PLAYMIDI program stored in your PATH).
  2557. + ROL Bank File now should be present in the MultiPlayer directory.
  2558. + Now LHARC archives can have .LZH or .LHA extensions.
  2559.  
  2560. -----------------------------------------------------------------------------
  2561.  
  2562. Release 2.01                                            (November 1st, 1993)
  2563.  
  2564. - Bug removed on Jump Command (Classic Mode).
  2565.  
  2566. -----------------------------------------------------------------------------
  2567.  
  2568. Release 2.00                                            (October 31st, 1993)
  2569.  
  2570. + A new world : you can play all mods in 4 playing modes (Classic, Advanced,
  2571.   DMP, Editing).  Advanced Playing Mode can pump up the frequency rate up to
  2572.   22000 Hz, resulting in a very good sound quality! Editing mode invoke Dark
  2573.   Tracker Editor (if you have it), and allows you to modify module.
  2574. + More powerful sound devices are available in Advanced Mode.
  2575. + MED support!! Since it's not still properly tested, it sounds good with  a
  2576.   good number of OctaMED modules.
  2577. + AMF internal support added (in Advanced/DMP mode).
  2578. + Multiplayer is now a CMF/ROL/VOC (Type 0) player shell too. You should ha-
  2579.   ve SPUTROL for a correct working on ROL files.
  2580. + LZMOD Archives supported. See documentation for more details.
  2581. + Added the 'D'  command during module playback.  Like 'S' command, it saves
  2582.   all module samples to disk, but it converts them before saving (from unsi-
  2583.   gned to signed, or vice versa)
  2584. + Now loop mode can be toggled by pressing '/' during module playback.
  2585. + 25/28/43/50 line display mode support enhanced. Added an MPENV environment
  2586.   variable for automatic setting of this parameter.
  2587. + Added a command line module player for all digital formats.
  2588. - 286 processor can be used in Classic Mode only, while Advanced and DMP mo-
  2589.   des use 386 instructions. So, 386 or 486 is strongly recommended now.
  2590. - SoundBlaster ASP 16's speaker volume setting removed from mixer. Now mixer
  2591.   supports only SoundBlaster PRO registers.
  2592.  
  2593. -----------------------------------------------------------------------------
  2594.  
  2595. Release 1.60                                          (September 16th, 1993)
  2596.  
  2597. + MultiPlayer Professional is now available! It supports SoundBlaster PRO or
  2598.   SoundBlaster ASP 16, more memory  for mods (about 8k!) and an internal mi-
  2599.   xer control panel!
  2600. + Added ProTracker Studio 16 (.P16) digital module support.
  2601. + MASTERVOL command in the Virtual Dos Shell is renamed to VOLUME.
  2602. + Added HELP command in the VDS, showing full VDS command list.
  2603. + Included the  AMFPLAY program, allowing you to play AMF mods, and RAWPLAY,
  2604.   a raw-sample player.
  2605.  
  2606. -----------------------------------------------------------------------------
  2607.  
  2608. Release 1.55                                           (September 5th, 1993)
  2609.  
  2610. + Added a command in the VDS: you can see compressed archive contents by ty-
  2611.   ping INSIDE <filename>.
  2612. + Added PAK and ARC archive shell support.
  2613. + Enhanced SoundBlaster Settings: you can change  I/O Port,  DMA Channel and
  2614.   IRQ directly from Setup Menu.
  2615. + Added 50 display line mode on VGA cards.
  2616. + Improved Bar Display Mode, making it more real.
  2617. + Added 'S' command: you can save module samples while MultiPlayer plays.
  2618. + Master Volume can be changed smoothly (at a step rate 1), if your keyboard
  2619.   has NUMLOCK key pressed.
  2620. - Removed a bug in the file requester, calculating in a wrong way total disk
  2621.   drives available.
  2622. - Removed a bug in the instrument loader.
  2623. - Bugs fixed on the PKZIP archive shell support.
  2624.  
  2625. -----------------------------------------------------------------------------
  2626.  
  2627. Release 1.50a                                            (August 23th, 1993)
  2628.  
  2629. - Bugs Removed.
  2630. + Now you can break a TYPE command in the VDS by pressing a key.
  2631. + In the VDS,if an error occurs when you perform a COPY, a RENAME, or a MOVE
  2632.   command, the error number will be displayed.
  2633.  
  2634. -----------------------------------------------------------------------------
  2635.  
  2636. Release 1.50                                             (August 20th, 1993)
  2637.  
  2638. - Several bugs removed.
  2639. + Optimized Main Source Code and Module Library in some critical point.
  2640. - Removed Time, since it conflicts with some DOS Interrupt Vector.
  2641. + Added PKZIP 1.x/2.x shell support.
  2642. + Added VDS (Virtual Dos Shell) subsystem: you can use a lot of DOS commands
  2643.   (especially file operations) while you play mods!
  2644. + Now you can change both Left and  Right Covox's  Port Address, if you have
  2645.   this device mounted  on another port.  Covox SoundMaster ][ can be used if
  2646.   you specify $22F as  Port Address.  Also, you can change SoundBlaster port
  2647.   from setup menu,  and SoundBlaster  DMA Channel  and  IRQ line by changing
  2648.   configuration file directly.
  2649. + Adjusted screen  mode so that it can  display up to 16 channels (bar mode)
  2650.   per song and 48 samples (sample mode).
  2651. + Adjusted colors: display uses a 16-color text screen on VGA cards.
  2652. + Enhanced support  for MonoChrome  Adapters (I know someone continue to use
  2653.   them....)
  2654. + When NUMLOCK light is turned on,you can mute channels 11 to 16 by pressing
  2655.   1-6 keys. Also, you can change its volume  by pressing usual keys assigned
  2656.   to channels 1-6.
  2657. + Quality Mode added: you  can improve  sound  quality  of mods (losing some
  2658.   chunk of memory).
  2659. + Adjusted file requester on  the screen,  making it bigger for viewing more
  2660.   mods at a time.
  2661. + ScreamTracker 3.0 extended commands are displayed correctly now.
  2662. + Added MonoMode and Spatial Stereo Sound for 669 Composer's modules.
  2663. + Who says: 'Intro Screen changed for last  time?' :-) A new screen  logo is
  2664.   shown when program is loaded.
  2665.  
  2666. -----------------------------------------------------------------------------
  2667.  
  2668. Release 1.22                                               (July 22th, 1993)
  2669.  
  2670. - Mr. Bug strikes again!  When you select more than one file, and play them,
  2671.   main window was not cleared. Now it's refreshed totally before a module is
  2672.   played.
  2673. + Changed Intro Screen, for last time!
  2674.  
  2675. -----------------------------------------------------------------------------
  2676.  
  2677. Release 1.21                                               (July 20th, 1993)
  2678.  
  2679. - Little bugs fixed...
  2680.  
  2681. -----------------------------------------------------------------------------
  2682.  
  2683. Release 1.20                                               (July 18th, 1993)
  2684.  
  2685. - A lot of little bugs fixed!
  2686. + File Device added to Sound Device Menu : it's possible to convert a module
  2687.   to a raw sample file.
  2688. + Now the  Sound Device Menu detects  automatically sound cards installed on
  2689.   your system, making other devices unselectable.
  2690. + Mono Mode and Spatial Sound Mode work also on STM mods now.
  2691. + You can change single  channel volume 'smoothly'  at a step rate 4,  while
  2692.   release 1.15 used step rate 8.
  2693. + Module sample list can be displayed by pressing F7.
  2694. + Module can be paused by pressing P.
  2695. + Multiplayer loads constant strings directly from disk,  so a lot of memory
  2696.   space is saved.
  2697. + Modified the display look a little.
  2698.  
  2699. -----------------------------------------------------------------------------
  2700.  
  2701. Release 1.15                                               (July 08th, 1993)
  2702.  
  2703. + Added Intro Screen, including thanks for VangelisTeam support.
  2704. + Increased available memory for mods  (about 2K). Maximum Module Size is so
  2705.   grown up, as described by the following table:
  2706.  
  2707.                    DOS Memory Free   Maximum Mod Size
  2708.  
  2709.   HIMEM.SYS             570k              345k
  2710.   HIMEM+VIDRAM          670k              445k
  2711.   QEMM386               635k              410k
  2712.   QEMM+VIDRAM           700k              475k
  2713.  
  2714. + Added pattern partiture display, 4 channels at a time.
  2715. + Added song time.
  2716. + Added help screens.
  2717. + Changed default bar shape, you can change it by pressing '<' and '>'.
  2718. + Enhanced LHA file selection window.
  2719. + Multiplayer  now recognizes the ModEdit format,  but it can play only five
  2720.   octaves (0-4) while ModEdit plays ten octaves (0-9).
  2721. - Removed system clock, 'cause of some conflict with song time.
  2722. - S2M format is no longer supported.
  2723.  
  2724. -----------------------------------------------------------------------------
  2725.  
  2726. Release 1.10c                                              (June 27th, 1993)
  2727.  
  2728. + About 5k RAM space more is  available for mods. Modules  bigger than  400k
  2729.   can be played now (if you have an expanded or any video memory manager in-
  2730.   stalled).
  2731. - Fixed some little bug in the soundblaster routines.
  2732.  
  2733. -----------------------------------------------------------------------------
  2734.  
  2735. Release 1.10b                                              (June 21th, 1993)
  2736.  
  2737. - Removed some little bug.
  2738.  
  2739. -----------------------------------------------------------------------------
  2740.  
  2741. Version 1.10                                               (June 20th, 1993)
  2742.  
  2743. - Fixed some bug causing Loop Mode to work incorrectly.
  2744. - Fixed a bug causing a  new module loaded to keep  tracks muted during last
  2745.   module playing.
  2746. - Fixed a bug displaying an error message if the module is 'short', that is,
  2747.   with less samples than number declared.
  2748. - Fixed a bug causing the configuration to be saved in the directory curren-
  2749.   tly selected by file requester.
  2750. - Fixed a bug displaying an incorrect available  memory rate in many circum-
  2751.   stances (eg. while module is playing).
  2752. - Fixed other minor bugs.
  2753. + Improved memory  handling routines,  so MultiPlayer  has now about 20k RAM
  2754.   free space more for modules.
  2755. + Improved volume settings: now you can change a single channel volume!
  2756. + Added NoiseTracker Mono/Stereo Mode for stereo devices.
  2757. + Added NoiseTracker Spatial Stereo Sound Mode for stereo devices.
  2758. + Added some nice color to text windows, and modified the screen look sligh-
  2759.   tly.
  2760.  
  2761. ------------------------------------------------------------------------------
  2762.  
  2763. Version 1.00                                               (June 13th, 1993)
  2764.  
  2765. + Initial release.
  2766.  
  2767. ==============================================================================
  2768.  
  2769.                                   CREDITS
  2770.  
  2771.                      Thanks for tips and bug reports, to
  2772.  
  2773.                               Pasquale Alfuso
  2774.                                Oscar Alvarez
  2775.                                 Paolo Cozzi
  2776.                                Piotr Karocki
  2777.                             Sabatino Volpicelli
  2778.  
  2779.